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300 - 14,400 (MNP, V.32BIS) N,8,1 Printed on 


e 24 Hour Operation recycled paper 


The Data Engine is a Kantronics hardware and software design incorporating the 
AX.25 Version 2 Level 2 Packet protocol as adopted by the American Radio Relay 
League. 


We have attempted to make this manual technically and typographically correct as of 
the date of the current printing. Production changes to the Data Engine may add 
errata or addendum sheets. We solicit your comments and/or suggested corrections. 
Please send to Kantronics Co., Inc., 1202 E 23rd Street, Lawrence, KS 66046. 


Printed in the U.S.A. 


© Copyright 1990-1993 by Kantronics Co., Inc. 
All rights reserved. 


Contents of this publication or the firmware described herein may not be reproduced 
in any form without the written permission of the copyright owner. 


Data Engine is a trademark of Kantronics Co., Inc. 


READ THIS PAGE BEFORE YOU INSTALL THE PRODUCT 
ASSOCIATED WITH THIS MANUAL 


The product with which this manual is associated contains SOFTWARE on Programmable 
Read Only Memory (PROM) or diskette which is protected by both United States copyright law 
and international treaty provisions. 


If you install or use the product associated with this manual, you will be deemed to be bound 
by the terms of the SOFTWARE license shown below. If you do not wish to be bound by such 
license, return such product and all associated documentation unused to your supplier for 
refund of the amount you paid. 


License Agreement 


1. License. In consideration of payment of the License Fee, which is included in the price of 
the product, the Licensee (you) is granted by the Licensor (Kantronics Company, Inc. — 
Kantronics) a non-exclusive right to use the SOFTWARE and associated documentation. No 
ownership rights to the SOFTWARE or its Documentation are transferred from Kantronics to 
you. 


2. Term. This License Agreement is effective until terminated. You may terminate this 
Agreement by destroying the PROM or diskette and documentation. You may not rent or lease 
the SOFTWARE, but you may transfer the SOFTWARE and accompanying written materials 
on a permanent basis provided you retain no copies and the recipient agrees to the terms of 
this Agreement. Kantronics may terminate this Agreement without notice if you violate any 
terms or conditions of the Agreement. In the event of termination of the Agreement, provisions 
relating to Kantronics’ disclaimers of warranties, limitation of liability, remedies, or damages 
and Kantronics’ proprietary rights shall survive. 


3. Object Code. The SOFTWARE is delivered in object code only. You shall not reverse 
compile or otherwise reverse engineer the SOFTWARE. 


4. Limited Warranty. This product is covered by the standard Kantronics Co., Inc. Limited 
Warranty, which is enclosed. 


5. General. This License Agreement constitutes the complete Agreement between you and 
Kantronics. 


The SOFTWARE and/or Documentation may not be exported or re-exported in violation of any 
export laws or regulations of the United States of America or any other applicable jurisdiction. 


This Agreement shall be governed by and interpreted under the laws of the State of Kansas, 
United States of America. 


Use, duplication, or disclosure by the Government of the United States is subject to restrictions 
as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer 
SOFTWARE clause of DFARS 252.227-7013. 


Kantronics may in its sole discretion, provide you with upgrades of the SOFTWARE and/or 
Documentation if you have provided Kantronics your completed Warranty registration with a 
copy of your receipt showing the amount you paid. 


LICENSEE ACKNOWLEDGES THAT IT HAS READ AND UNDERSTANDS THIS 
AGREEMENT AND AGREES TO BE BOUND BY ITS TERMS. LICENSEE FURTHER 
AGREES THAT THIS AGREEMENT IS THE COMPLETE AND EXCLUSIVE STATEMENT 
OF THE AGREEMENT BETWEEN LICENSEE AND LICENSOR AND SUPERSEDES ANY 
PROPOSAL OR PRIOR AGREEMENT, ORAL OR WRITTEN, AND ANY OTHER 
COMMUNICATIONS RELATING TO THE SUBJECT MATTER OF THIS AGREEMENT. 


Any questions concerning this Agreement or any other matter relating to Kantronics Company, 
Inc. products or business practices may be directed to: 


Customer Service Department 
Kantronics Company, Inc. 
1202 E. 23rd Street 
Lawrence, KS 66046 
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KANTRONICS CO., INC. 
LIMITED WARRANTY 
Effective December 1, 1992 


To be sure you will receive notice of future updates, new product information and prompt 
warranty service, please take a moment to fill in the Kantronics/rfconcepts Warranty 
Registration card COMPLETELY and return it along with a copy of proof of purchase (to 
establish purchase date) to Kantronics Co., Inc., 1202 East 23rd Street, Lawrence, Kansas 
66046 USA. Return of the Warranty Registration card and proof of purchase is a pre- 
condition to warranty coverage. 


1. WARRANTY. Kantronics Co., Inc. (“Kantronics”) warrants to the first consumer purchaser 
(“you”), for the Applicable Warranty Period (as described below), that the Applicable Product 
(as described below) will be free from defects in material and workmanship. 


2. REMEDY. Kantronics agrees that, for any Applicable Product found by Kantronics to be in 
violation of the warranty of Section 1 hereof within the Applicable Warranty Period, it will, at 
its option, repair or replace the defective Applicable Product at no charge to you, excluding in- 
bound shipping charges. 


3. EXCLUSIVE REMEDY. Repair or replacement of the Applicable Product, as provided 
herein, is the sole remedy available to you against Kantronics, and in no event will Kantronics 
be responsible for any other liability or damages or for incidental, special, or consequential 
damages, regardless of whether purported liability is predicated upon negligence, strict tort, 
contract, or other products liability theory and whether or not Kantronics is warned about the 
possibility of such liability or damages. SOME STATES DO NOT ALLOW THE 
EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, 
SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. 


4. DISCLAIMER. This Limited Warranty is in lieu of all other warranties expressed or 
implied and no representative or person is authorized to assume for Kantronics any other 
liability in connection with the sale of its products. KANTRONICS SPECIFICALLY 
DISCLAIMS THE IMPLIED WARRANTY OF MERCHANTABILITY AND IMPLIED 
WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE FOR ANY APPLICABLE 
PRODUCT. IF HOWEVER, YOU ARE A CONSUMER WITHIN THE MEANING OF 15 U.S.C. 
§ 2301(3), THE ABOVE DISCLAIMER OF IMPLIED WARRANTIES IS EFFECTIVE ONLY 
FOR PERIODS OUTSIDE THE APPLICABLE WARRANTY PERIOD. SOME STATES DO 
NOT ALLOW LIMITATIONS ON HOW LONG AN IMPLIED WARRANTY LASTS, SO 
THE ABOVE LIMITATION MAY NOT APPLY TO YOU. 


5. APPLICABLE PRODUCTS AND PERIODS. Kantronics products are of two types — (1) 
hardware units and (2) firmware and software for operation of these units, whether 
incorporated into the units themselves or separate from the units as adjuncts or accessories to 
the units. Hardware units and the media containing firmware, software and documentation are 
sold to the consumer purchaser and become property of the purchaser. Firmware and software 
are licensed for use by the consumer purchaser in return for a fee included in the purchase 
price of the units and do not become the property of the consumer. (See separate License 
Agreement provided with these products). The products to which the warranty of Section 1 
hereof applies (herein “Applicable Products”) and the periods during which the warranty shall 
apply to such products (herein, “Applicable Warranty Period”) are as follows: 


Applicable Products: 
UNITS: 
KAM Plus, KAM, KPC-2, KPC-3, KPC-4, Data Engine, DVR2-2, D4-10, KTU, 
rfc 2/70, rfc 2/70G, rfc 2/70H, rfc 2-23, rfc 2-217, rfc 2-117, rfc 2-315, rfc 2-317, 
rfc 2-417, rfc 4-32, rfc 4-110, rfc 4-310, rfc 3-22, rfc 3-211, rfc 3-112, rfc 3-312, 
VHF1-60 


Applicable Warranty Period: 
One (1) year from date of purchase. 
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ACCESSORIES: 
Anemometer, Rain Gauge, Temperature Sensor (for KTU units) 


Applicable Warranty Period: 
Sixty (60) days from date of purchase. 


DE1200 modem, DE19K2/9K6 modem, DE Jumper Board, KAM Enhancement 
Board, MSK modem, Watchdog Timer 


Applicable Warranty Period: 
One (1) year from date of purchase. 


MEDIA: 


EPROMS, diskettes, video or audio cassettes, manuals (however bound), specifica- 
tion and other supplemental pages or any other media on which firmware, software 
or documentation are supplied 


Applicable Warranty Period: 
Thirty (30) days from date of purchase. 


6. EXCLUSIONS. This Limited Warranty does not apply to the cosmetic appearance of the 
Applicable Product; to broken or cracked cabinets; to any accessory not supplied by Kantronics 
which is used with the Applicable Product; to any product that has been subject to misuse 
abuse or overvoltage; to any product that has been modified by non-Kantronics personnel 
unless specifically authorized in writing by Kantronics; or to any product damaged or impaired 
by shipping (whether or not caused by poor packaging), neglect, accident, wiring not installed 
by Kantronics, improper parameter settings which are cleared by performing a hard reset, or 
use in violation of instructions furnished by Kantronics or of generally accepted industry 
practice. Kantronics does not warrant that the functions contained in any software will meet 
your requirements or achieve your intended results; or that operation of any software will be 
uninterrupted or error-free or without effect upon other software used with it. Responsibility 
for the selection of the hardware and software program to achieve your intended results rests 
with you. 


7. REMEDY PROCEDURE. Should you need to make a warranty claim, first contact the 
dealer from whom you purchased the product. If the dealer is unable to assist you, contact 
Kantronics Co., Inc., by mail at 1202 East 23rd Street, Lawrence, Kansas 66046 USA; by fax at 
913-842-2021; or by phone at our Customer Support number 913-842-4476. Contact us prior to 
returning an Applicable Product to receive a Return Authorization Number. (As a practical 
matter, problems can often be solved in such a manner without the product having to be 
returned to Kantronics for repair or replacement.) 


Return of any Applicable Product for the enforcement of rights under this Limited Warranty 
shall be at your expense. Any product returned for warranty service which Kantronics 
determines to be without defect or not covered by this Limited Warranty shall be subject to a 
minimum charge of one-half hour labor rate and the product will be returned to you at your 
sole expense. Please note, no warranty service will be provided until Kantronics has been 
furnished with your Warranty Registration card and copy of proof of purchase establishing 
purchase date. 


8. NON-ASSIGNMENT. This Limited Warranty is not assignable by you. Any attempt to 
assign or transfer any of the rights, duties, or obligations hereof is void. 


9. OTHER RIGHTS. This Limited Warranty gives you specific legal rights and you 
may also have other rights which vary from jurisdiction to jurisdiction. 


LS 
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Return/Repair Procedures 
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Consult the limited warranty policy in this manual for the service provisions offered 
by Kantronics at no charge. This warranty is considered to be in force only when 
the customer has submitted his completed warranty registration within 10 days 

of purchase, and when the stipulations of the warranty have been met. Violations of 
warranty clauses will automatically void the warranty and service or repairs will be 
charged to the owner. 


Service outside the warranty will be charged at the cost of parts, labor, and return 
shipping. Units returned for service without a Return Authorization number will be 
subject to a minimum charge of 1/2 hour labor plus shipping and handling. Contact 
the Service Department (913-842-4476) to obtain a Return Authorization number. 
Repaired units will be returned via UPS C.O.D. These C.O.D. charges can be avoided 
by including your VISA or MasterCard number with your unit to be repaired. Shipping 
and repair may then be charged. 


When service or repairs appear necessary, it may be wise to call or write Kantronics 
to determine if the problem can be solved without returning the unit. Should you 
encounter difficulty in getting your Data Engine to “talk” to your computer, you may 
wish to perform some limited checks before calling or writing. Carefully check your 
wiring connections to the RS-232 port. Verify your terminal baud rate. It may be 
useful to perform a “Hard Reset”. (See Hard Reset section.) 


When calling, report the product name and ask for the Amateur Radio Service 
Department. Should you find it necessary to call for assistance, please have the 
following information available: 


1. The unit name and serial number (the serial number is found on the rear 
panel.) 


2. The firmware version number (the version number is displayed when you 
give the Version command.) 


If possible, you should have the Data Engine and your computer available to perform 
troubleshooting operations when you call. 


The Service Department telephone hours are 9 am - noon and 2 pm - 5 pm 
Central Time 913-842-4476, Monday through Friday. 


When writing, include a clear description of the problem, unit name, computer type, 
computer software used and if possible a DISPLAY listing from the Data Engine. 


Returns to the factory for refund or exchange are strictly regulated. Any return for 
refund or exchange must be approved by the service department. 


International Returns 


In case of unit problems, first contact the dealer from whom you purchased the 
product. If you must return a Kantronics product to us, please observe the steps 
outlined below. It will save both you, the customer, and Kantronics unnecessary 
difficulties and expense. 


1. All returns must be shipped to the factory at 1202 East 23rd Street, Lawrence, KS 
66046 USA. 


2. All expenses of returning item(s) to Kantronics must be paid by you, including any 
duty/entry fees, whether the return is for warranty or non-warranty repair. 
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3. Usually, the best way to return item(s) to us is by mail. However, if you wish to 
use one of the courier services such as DHL, Federal Express, etc., be sure to use 
DOOR-TO-DOOR service. If you use one of these services, a commercial invoice 
may be required. Please check with your carrier before shipping. 


4. Include in the description of the item(s) on the paperwork (whether postal or 

courier) the words: 
“U.S. GOODS RETURNED FOR REPAIR/REPLACEMENT.” 

An additional description of “Amateur radio peripheral equipment”, or “Data 
communications equipment”, would be helpful. It would also be helpful (but not 
required) to include the code number 9801.00.1035 9 which tells U.S. Customs 
agents that the package contains “U.S. goods returned without improvement/ 
enhancement”. However, if the words “U.S. goods returned for repair/replacement” 
are on the paperwork, the number is not really necessary. 


5. Provide a value for customs purposes. This is usually the value of the item(s) in 
their current condition. A $0 value is not acceptable for U.S. Customs. 


6. Inside the package, with the item(s), include: 
¢ a fax number (if available) in case we need to contact you 
¢ acorrect and full address for return 


¢ method of payment to be used for any charges (if MasterCard or VISA, 
include expiration date). 


¢ a brief description of the problem 


¢ a reference to any conversations with the technical/sales staff about the 
problem 


¢ and the Return Authorization number assigned. 


7. For warranty repairs, we will pay the shipping charges to return the item(s) to you 
via air parcel post. If you wish return by courier service, include your account 
number. To be eligible for repair under warranty, we must have a record that you 
sent your Warranty Registration card and proof of purchase to Kantronics, and the 
item(s) must still be within the warranty period at the time the return is 
authorized. 


8. For non-warranty repairs, you must pay the return shipping charges. 
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NOTE: This equipment has been tested and found to comply with the limits for 

a Class B digital Device, pursuant to Part 15 of the FCC rules. These limits are 
designed to provide reasonable protection against harmful interference in a residential 
installation. This equipment generates, uses and can radiated radio frequency energy 
and, if not installed and used in accordance with the instructions, may cause harmful 
interference to radio communications. However, there is no guarantee that the 
interference will not occur in a particular installation. If this equipment does cause 
harmful interference to radio or television reception, which can be determined by 
turning the equipment off and on, the user is encouraged to try to correct the 
interference by one or more of the following measures: 


¢ Reorient or relocate the receiving antenna. 
¢ Increase the separation between the equipment and receiver. 


¢ Connect the equipment into an outlet on a circuit different from that to which 
the receiver is connected. 


¢ Consult the dealer or an experienced Radio/TV technician for help. 


The user is cautioned that any changes or modifications not expressly 
approved by the party responsible for compliance could void the user’s 
authority to operate the equipment. 


In moving to the world of digital communications via computers, a new dimension of 
RFI may be encountered. In spite of the equipment manufacturers’ diligence, each 
new piece of electronic equipment will react differently in each separate environment. 
Every amateur station will have its own unique layout, equipment variation, and 
antenna installations. Experience has shown that these differences are related to the 
total RF environment, and may be causative factors in RFI induced problems. The 
suggestions given here may assist in resolving RFI problems you may encounter in 
your “unique” station. 


1. Use shielded cable for all connections between equipment. 


2. Make all interconnecting cables as short as practical. A balance should be 
maintained between cable length and equipment proximity. At times simply moving 
the video monitor one foot further from an interface or other device will solve the 
“screen hash” problem. 


3. Antenna runs should be kept away from equipment control lines and/or 
interconnecting cables. If it is necessary for such lines to cross each other they 
should do so at 90 degree angles. 


4. Ground leads should be as short as possible and go to aGOOD EARTH GROUND. 


5. Interconnecting cables appearing to act as radiators or antennas should be looped 
through a toroid. Be certain toroids, if used, are designed for the frequency in use. 
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Precautions 


The Data Engine PC board is a four-layer PC board. Do not attempt any modifications 
to this board unless you are experienced in the repair of multi-layer circuit boards. If 
you damage the board, it cannot be repaired at the factory, and a new unit must be 
purchased. 


The Data Engine is grounded through its connections to your transceiver. Make sure 
your transceiver is properly grounded and your computer has equal ground potential. 
Follow the grounding instructions in your transceiver manual. 


The lithium battery can explode or leak if heated, disassembled, recharged, exposed to 
fire or high temperature, or inserted incorrectly. 
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CTRL-x This is a two key combination. CTRL is the control key and x represents any 
alpha character. Press the CTRL key and while holding it down type the letter x (this 
can be capital or lower case, but will be shown as capital). Then release both. If your 
computer keyboard has no key labeled CTRL, consult your computer manual to 
determine which key performs the control key function. 


$ preceding a number denotes a hex number (base 16) 
<CR> = carriage return, $0D, decimal 13, CTRL-M 
<LF> = line feed, $0A, decimal 10, CTRL-J 

I/O = Input/Output 


Computer and terminal are used interchangeably to describe whatever device is 
attached to the RS 232 port of the Data Engine. 


The terms Data Engine and TNC are used interchangeably. 
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Plug the two-pin molex connector into your Data Engine port labeled Power 12 VDC, 
and connect the black wire from this connector to the ground (—) of a regulated 12VDC 
power supply. The red lead from this connector should be connected to the plus (+) side 
of the power supply. The Data Engine requires less than 200 ma of current. 
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Connecting the Data Engine to Your Computer 


The Data Engine serial port uses RS-232 levels to communicate with the computer. 
In order to make the required connections, strip the free end of the supplied modular 
cable, add a connector, and attach it to your computer serial port according to the 
following pin-out chart. 


As you look at the rear of the Data Engine, the serial port is the modular connector on 
the right side of the rear panel (named RS 232). The pins of the modular connector are 
numbered from left to night. 


DE Purpose Computer Computer / 

pin DB-25 pins DB-9 pins Om 

1 DSR 6 6 al 

2 DCD 8 1 ; 
3 DTR 20 4 Z 

4 SG 7 5 Dro 
5 RD 3 2 

6 TD 2 3 

7 CTS 5 8 

8 RTS 4 l i 


RS 232 


W258 35 455860/28 


Pin numbers when facing the 
rear panel of the Data Engine 


As a minimum, you must connect pins 4 (SG), 5 (RD), and 6 (TD) from the Data 
Engine to your computer. This minimum cable supports only software flow control. 
In addition, your software program may require other lines. Refer to your software 
documentation for any special wiring requirements. 


Normal hardware flow control requires the CTS and RTS lines to be connected 
(pins 7 and 8 from the Data Engine) to your computer. 


Some terminal programs will also support a full RS-232 configuration. In these cases, 
wire all eight pins from the Data Engine to the appropriate pins on your computer 
serial port. 

For a description of the RS-232 signals see the appendix “Definition of RS-232 
signals”. 
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Connecting the Data Engine to Your Radio 
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The Data Engine is connected to your radio(s) through the radio port connectors on 
the rear panel (Port 1 and Port 2). The exact connections required will depend on the 
modem you have installed in your Data Engine. ( 


Refer to the manual that was shipped with your modem for details on the wiring of 
your radio to the Data Engine. If you wish to use a non-Kantronics modem, refer to 
the appendix “Connecting Other Modems to the Data Engine” for more details. 


Assembly and Disassembly of the Data Engine ~ 


Should you require access to the Data Engine to reposition jumpers or for other 
purposes, disassemble as follows: 


1. Turn off power to your Data Engine and remove all cables from the unit. 


2. Using a small phillips screwdriver, remove the two rear-panel screws just 
far enough to free the panel and bezel. 


3. Pull the rear-panel, bezel, and circuit board out of the case from the rear 
of the unit. 


To reassemble, reverse the procedure above. You may wish to remove the front panel 
prior to inserting the circuit board into the case, as this is generally easier in lining 
up the LEDs. 


Hard Reset 


The hard reset process is provided to re-initialize the Data Engine to its factory 
default values. This process may become necessary should operational problems be 
encountered or when upgrading your firmware to a new version. This procedure is 
performed as follows: 


1. Remove the PC board from the case as outlined in the Assembly and 
Disassembly section. 


2. Locate jumper JP5 on the PC board. This jumper is located on the right 
edge of the circuit board, near the battery. 


3. Remove the jumper. This disables the battery backup circuit, and the 
entire RAM will be erased. 


4. Re-install jumper JP5 to enable the battery backup. 


5. Reassemble the Data Engine and return to operation. The Data Engine 
will now appear as though it had just been shipped from the factory. 


a 
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Intro / Getting Started 


Now that you have your new Kantronics unit connected to your radio and computer, 
let’s take a moment for an overview of its operations, and how you might communicate 
with it. The Data Engine is a Terminal Node Controller (TNC). In some ways it is very 
similar to a telephone modem because it receives digital signals from your computer 
(Terminal) and converts them to tones suitable for transmission to a distant location. 
The TNC also receives tones from your radio, and converts them into the digital 
signals understood by your computer. A TNC, however, does much more because it also 
controls the push-to-talk line of your transmitter, keying the radio whenever it needs 
to send data. It also converts data into packets, adding the required addressing, error 
checking, and control information to insure the data gets from one Node to the next. 
The error checking implemented in your TNC must be the same as the error checking 
used by any other station you want to talk to, and this standard method is called a 
protocol. The protocol used in Amateur Radio Packet TNCs is called AX.25. Different 
protocols are used for other modes of operation, such as AMTOR. 


In order for your Data Engine to do something, you must issue instructions to it, 
letting it know exactly what you want done. In order to accomplish this, the Data 
Engine must be in Command Mode (expecting you to give it instructions) and any time 
you want to change the way your Data Engine operates, you must be in this mode. The 
Data Engine tells you that it is ready for your commands by sending you the prompt 
ccm: . 


When you first turn on your Data Engine out of the box (or after a hard reset), you 
may see some garbage characters on your screen. The Data Engine is performing 

an autobaud routine. It is sending the same message over and over again at different 
baud rates. When the Data Engine baud rate matches the baud rate set in your 
terminal (communications) program the display will read: 


PRESS * TO SET BAUD RATE 


When these words are readable press the asterisk, *, on your keyboard. This will 
set the baud rate and the Data Engine will display the following: 


ENTER YOUR CALL 


At this point enter your amateur callsign. This callsign will be used by the 

Data Engine for many different things, including being in every packet you send, 
and deciding if a packet it receives is specifically for you. Now you should see the 
sign-on message and command prompt on your screen: 


Kantronics Data Engine Version 2.0 
(C) Copyright 1990,1991,1992,1993 by Kantronics Inc. All nghts reserved 
cmd: 


The cmd: prompt means the Data Engine is ready to listen to you. Anything you type 
will be interpreted as a command. If the Data Engine doesn’t understand, it will 
display: 

EH? 
All commands are listed alphabetically in the Commands section, and many are 
discussed in the following sections. Some commands require a parameter, called an 


argument. You would type the command, a space and then the argument (a number 
or whatever is appropriate). 
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Asynchronous commands are commands that allow your Data Engine and computer to 
talk the same language. These commands in the Data Engine will have their counter- 
parts in your computer program, although some programs may limit what you can set. 
Following is a list of Data Engine command defaults and their corresponding computer 
settings. We will explain below, in more detail, the settings involved. 


Data Engine Computer 
MODE b,p,d,s 
Deru Baud Rate 
p = NONE Parity no or none 
siete) Data Bits or Word Length 8 
s=1 Stop Bits 1 
ECHO ON Full Duplex 
FLOWR ON and 
FLOWX ON Software Flow Control 


Baud Rate is the rate that your computer and Data Engine communicate with each 
other. This is set in the Data Engine with the MODE command. The settings allowed 
by the Data Engine are 0 and continuous from 300 to 38400. The Data Engine sets the 
MODE command to match your computer speed when you first press the * during the 
autobaud routine. If you set the MODE command to 0, you will always have to go 
through the autobaud routine of typing the asterisk. To change this parameter, type 
MODE, press the space bar and type the number you wish to use. Next type the 
RETURN or ENTER key on your keyboard. All commands will be entered in this 
fashion. 


The MODE command controls many settings. When entering the command, settings 
are separated by commas. If you wish to leave a setting unchanged, you may omit the 
setting, but the comma must be present (except for trailing commas). 


Word Length and Data Bits are often used interchangeably to refer to how many 
bits are used to recognize a character. Each character is made up of smaller elements 
called bits (analogous to a dit or dah in morse code). These bits are seen as high or low 
voltages (ones or zeroes) on the cable between the Data Engine and computer to make 
the desired combination for a character. A standard by the name of ASCII allows 

8 bits for each character, although all the standard alphanumeric characters and 
punctuation can be recognized with only 7 bits. The Data Engine will talk to the 
computer using either 7 or 8 bits depending on the setting of the MODE command. 


Parity determines what type of error checking will be used between the Data Engine 
and the computer. Few modern programs will provide any indication of errors when 
using parity, so normally you should set this to NONE. If set to any other value, one 
parity bit will be added to the data going to your computer, so if the word length is set 
to 8, there will be nine (9) bits exchanged between the computer and the Data Engine 
for every character you type or every character received. Your terminal program must 
be capable of matching the Data Engine settings. If the word length is 8, the full 8 bits 
of data will be transmitted over the radio regardless of the setting of parity. If the 
word length is set to 7, you can not transmit 8-bit data regardless of the parity setting. 
The most common (and recommended) setting for MODE and your terminal program 
is 8 bits, no parity. 


Stop Bits are the number of bits that must be after the end of the character. The 
Data Engine may be set to 1 or 2. 
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Full Duplex or Half Duplex. (Some programs use the term Echo for Half Duplex.) 
When using Full Duplex the computer expects the attached device to send back (echo) 
what was sent to it. A setting of Half Duplex will tell the program that it must display 
on the screen what you type. The Data Engine’s default is ECHO ON which tells the 
Data Engine to send back what it receives. This corresponds to a setting of Full 
Duplex for the computer. If you set your computer for Half Duplex you will need to 
turn ECHO OFF or you will see two of everything you type. When using a split-screen 
program you may want to set ECHO OFF in the Data Engine because the program 
will be handling what you type and driving the display also. 


Flow Control. Often times one device may talk to another device faster than it can 
handle the information. When this happens the excess information is stored in a buffer 
until it can be processed. This buffer is only so large. If the data were to over-flow 

the buffer, it would be lost. Flow Control is the terminology used for how the devices 
inform each other to stop or start sending data. There are two ways to accomplish this, 
software and hardware. The Data Engine’s default FLOWR ON and FLOWX ON 
allows the Data Engine to implement software flow control (hardware flow control is 
always recognized by the Data Engine). 


Software Flow Control is implemented by the program and Data Engine looking at 
the data and watching for two certain characters. One of these characters (normally 
CTRL-S) tells the device to stop sending data and the other (normally CTRL-Q) tells 
the device to restart sending data. The Data Engine commands XOFF and XON tell 
the Data Engine which characters to send to the computer to stop and start data flow. 
The commands STOP and START define which characters the Data Engine expects 
from the computer. The default values for these commands are set for normal software 
flow control. 


Hardware Flow Control is implemented by the devices watching the voltages on the 
RTS and CTS pins of the RS-232 port. The Data Engine will always monitor these pins 
so only connect them if you are going to use them. If you use hardware flow control, 
you should turn FLOWR OFF and FLOWX OFF. See “Connecting the Data Engine to 
Your Computer” for how to wire your RS-232 cable for hardware flow control. 
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Al —- XMIT Port 1. This LED illuminates when the Data Engine keys the PTT line of 
the radio connected to Port 1. 


A2-RCV Port 1. This LED illuminates when the Data Engine detects a signal on the 
radio frequency of the radio connected to Port 1. 


A3 — CON. This LED will illuminate when you have a packet connection on the 
current stream. The current stream is the stream to which the I/O is directed. (See 
STREAMSW in the Commands section.) 


A4 — STA. This LED will illuminate when you have unacknowledged packets on the 
current stream. 


A5 — MAIL. When the PBBS is holding mail addressed to you, this LED will blink. 
A6 — unused 


A7 — XMIT Port 2. This LED illuminates when the Data Engine keys the PTT line of 
the radio connected to Port 2. 


A8 — RCV Port 2. This LED illuminates when the Data Engine detects a signal on the 
radio frequency of the radio connected to Port 2. 


AUX - This switch is used for factory testing, and should be OUT for normal 
operation. Turning the unit on with this switch depressed could cause undesirable 
results. 


ON/OFF -— This switch provides power control for the Data Engine. When depressed 
power is applied to the Data Engine from the Power +12VDC port on the rear. 


Power — This LED will illuminate when power is applied. 
NOTE: If the LEDS command is OFF, only the Power LED will illuminate. 


SS 
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Packet Mode and 
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Packet radio is the communication of digital data via radio. A packet is a group of 
characters with a flag and header at the beginning and a checksum and flag at the 
end. A flag is a specific character used to signify the beginning and ending of a packet. 
The header is information concerning who the packet is from, who it is to, any relay 
stations needed to get to the destination and some control information. A checksum 

is a complicated mathematical formula that produces a number that is unique to the 
combination of characters that are in the packet. This unique number is calculated 

by every station that handles the packet and if it does not match the number that is 
contained in the packet, the packet is thrown away, thus error-free communications. 
A packet is also called a frame. 


The Terminal Node Controller (TNC) is the workhorse of Bese radio. (The Data 
Engine is a TNC). As a listening device it hears an audio signal from the radio, 
changes the data to digital form, determines if it is a good packet and sends it to 
whatever device is attached, usually a computer. As a relay device it also checks the 
packets it receives and determines if the packets need to be resent, then does so if 
appropriate. As a sending device it receives digital data from the computer, packetizes 
it and changes it into audio tones which are sent out to the radio. The rules the TNC 
uses to do all of this is called a protocol. 


The most used protocol in amateur packet radio is AX.25 Level 2 and the nitty gritty 
details of the inner workings can be found in a book named AX.25 Amateur Packet- 
Radio Link-Layer Protocol available from the ARRL. Many of you are not going to 
want to go that deep, the TNC takes care of the nitty gritty work for you, although 
there are parameters you can set that determine how efficiently some of that work is 
done. In this section of the book we will be discussing the fundamentals of how to get 
on the air and how parameters interrelate. The default parameters will get most 
everyone on the air, but by using this information you can change your parameters to 
be most efficient in whatever situation you find yourself. 


Command Mode 

In order to change parameters, or give any other instructions to the TNC you must be 
in Command Mode. This is the mode you will be in when you turn on the TNC (unless 
the INTERFACE command is set to KISS or HOST). Once you have left Command 
Mode for any reason there is a parameter called COMMAND that determines what 
special character you will use to return to Command Mode. This comes defaulted as 

a CTRL-C. (While holding down the control key press “c”, then release both.) All 
parameters are described in alphabetical order in the Commands Section. Whenever 
you enter Command Mode the TNC will send a prompt to your screen that looks like 
this: 


cmd: 
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There are two ways to send data in packet radio, connected or unproto (unconnected). 
In the Connected Mode you first establish a connection. Then your TNC will send 
packets to that specific station and expects acknowledgments in return. If an acknowl- 
edgment is not received, the TNC will resend the data (depending on the setting of 
AX25LVL it may send a poll first). The RETRY parameter will determine how many 
times this is done before the connection is lost due to bad conditions. If the acknowl- 
edgment is received the TNC is happy and will send more data, when available. 
Therefore the Connected Mode, barring impossible conditions, assures that the station 
you are connected to will receive everything you say, and in the order you say it. 


In the Unproto Mode your TNC sends a packet. As far as the TNC is concerned the 
packet is not directed to a specific station therefore no acknowledgment is expected 
and no retrys are attempted. This mode is often used for calling CQ and informal 
round table chit chats. 
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You will notice two callsigns at the beginning of each packet separated by a “>”. The 
first callsign is the station the packet is from. And the second callsign is the station 
the packet is to. An Unproto packet may have a name or CQ for the second callsign. 


To set what will be seen as the “to” callsign of an Unproto packet you use the 
UNPROTO command. This comes defaulted as CQ, but if you wanted to put in your 
name instead, you would be sure you are in Command Mode and issue a command 
similar to this: 


u name<CR> 


where u is short for unproto, name is your name and <CR> is the return or enter key 
on your computer keyboard. In order to call CQ you must get into the Convers Mode, 
so that what you are typing to the TNC will be interpreted as data to be sent out on 
the air and not as commands. To do this type: 


k<CR> 


Now anything you type will be packetized and sent out on the air. Remember to get 
back to Command Mode you enter a CTRL-C (default) by holding down the Control 
key while pressing “c”. You will be going between Command and Convers Modes 
depending on if you want to talk to the TNC or have the TNC packetize what you 
type to go out on the air. 


The commands MONITOR, MONLIST, MONMODE and MONTYPE determine what 


packets you will monitor. 


A Simple Connect 


Once you see a station you would like to connect to, be sure you are in Command 
Mode, and issue a connect request, example: 


c callsign<CR> 


where c is short for connect and callsign is the callsign of the station you wish to 
connect to. If for any reason the connection fails the TNC will send the following 
message to your screen: 


*** RETRY COUNT EXCEEDED 
*** DISCONNECTED 
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When your TNC does receive an acknowledgment for a connect packet it will display 
a message on your screen like: 


*** CONNECTED TO callsign 


and your TNC will change to the Convers Mode (dependent on the setting of 
CONMODE). Now what you type will be interpreted by the TNC as data to be sent to 
the other station and not commands to the TNC. The MONMODE parameter comes 
defaulted to NONE. Therefore once you are connected all you will see is what you type 
and what the other person sends you. Any packets sent by other people will not be 
monitored. 


Two things determine when the data will be packetized. One is the parameter 
SENDPAC. This is defaulted as the return or enter key. As you are typing your 
message, whenever you hit the return or enter key you are telling the TNC to make a 
new packet. A second parameter, PACLEN, determines the maximum length of any 
packet. If you enter data longer than this length, a packet will be made, even though 
you have not pressed the return or enter key. 


When you have finished your conversation you need to end the connection. To do this 
you go into the Command Mode and type a “d” for DISCONNECT. Remember to press 
the return or enter key after any command to the TNC. Once your station has received 
the acknowledgment for the disconnect packet the TNC will send this message to your 
screen: 


*** DISCONNECTED 


Either station can issue the disconnect command, no matter which station originated 
the connect. 


Digipeating 

Everything we have done so far will only be heard by those within range to hear 

your signal. With packet radio it is possible to get further than that. The DIGIPEAT 
parameter in the TNC comes defaulted ON. This makes you a possible relay station, 
or digital repeater — digipeater, or just digi for short. In many VHF communities 

one, or more, of these is put up in a good, high location and referred to as a dedicated 
digi. The TNC and radio is all that is needed for the digital repeater to do its job. A 
computer would be needed if you wanted to change a parameter, but it would not need 
to stay there for the digi to work. The higher the antenna, the more effective a digi 
will be, but remember every TNC has the capability of being a digipeater. 


If we add PATH to the MONMODE command (enter MONM +PATH at the cmd: 
prompt) we will begin to see more than just the “from” and “to” stations of the 
monitored packets. We will also see the callsigns of those stations that have 
been used as digipeaters. (If you add HEADER to the MONMODE command 
(MONM +HEADER) the headers will end with a return and be on a separate 
line from the packet data.) This list of stations is often called a path. Here is an 
example of what you might see: 


WK5M>KA5ZTX via IAH*,LAG,AUS: 
Hi there 


In this example WK5M is talking to KA5ZTX using the digipeaters IAH, LAG and 
AUS. The asterisk beside IAH tells you that you are hearing that digipeater. You will 
notice that IAH, LAG and AUS are not real callsigns. The TNC parameter MYALIAS 
sets up an alias, which is often easier to remember than a callsign. To make this 
connection, WK5M would have typed the following command to his TNC: 


c ka5ztx v iah,lag,aus 


Data Engine May 12,1993 Version 2.0 PACKET 
© Copyright 1990-1993, Kantronics Co., Inc. All Rights Reserved. 
Duplication of this manual or the firmware without permission of Kantronics Co., Inc. is prohibited. 1 5 


v is short for via and up to 8 digis may be used. You must specify digis in the order 
they will be encountered along the path from your station to the station you wish to 
connect to. A space must be typed after the “c” and on both sides of the “v”, but digis 
are separated by commas and no spaces. A path can also be used with the UNPROTO 
command: 


u cq v nom, !ch,sli,bix 


Unproto sets up the path for anything that is subsequently typed in the Convers Mode 
where no connect exists. Connect issues a connect request to the specified station, via 
the specified path. Then an error-free conversation can take place between the two 
stations. 


When digipeating, the packet goes all the way from the first station, through all relay 
stations, then to the destination station. Then the response also has to take this same 
path in reverse. Chances for collisions, therefore retries, are multiplied with every digi 
used. This is often called end-to-end acknowledgment. Another way to get from one 
place to another is to connect to a “node”. A node will take care of the acknowledgment 
between it and the next node or end user. Ask your local packeteers about other kinds 
of nodes which may be in your area, such as TheNet and Net/Rom, KA-Node, Rose 
Switch, G8BPQ Packet Switch. 


When two modems are installed in the Data Engine a Gateway is also available. This 
is similar to digipeating except that the retransmission of the packet takes place on 
the other radio port of the TNC from where it was received. 


To enable this mode, the MYGATE parameter needs a callsign that is different than 
any other callsign parameter. 


Multi-Connects 

The TNC makes it possible for you to talk to more than one person at the same time, 
if you want to. A stream (or channel) is used for each conversation. The command 
MAXUSERS determines how many streams may be used at one time. And the 
command USERS determines how many people can connect to you. An incoming 
connect uses the next available stream. If the number of streams set by USERS is 
full, then that station will get a busy message instead of a connect. However, if 
MAXUSERS is set larger than USERS, you can still issue outgoing connects on the 
additional streams. 


The character specified in the STREAMSW parameter is used to change from one 
stream to another. The streams are lettered A - Z. So in order to change streams you 
type the STREAMSW character and then the letter designator for the stream you 
want (no return or enter in this case). This can be done in Command or Convers 
Modes. 


For an example, let’s assume I have my streamswitch set to a “|” (this may appear as 
a broken bar on your keyboard, or screen display) and I am connected to two stations: 
one on stream A and one on stream B. When I want to talk to the person on stream A, 
I type “la” and then whatever I want to say. To talk to the person on stream B, I need 
to type “Ib” then what I want to say. (Note that a carriage return is not required to 
switch streams.) If the PORT command is set to 1 or 2, two streamswitches will be 
defined in the Data Engine. By default these are the “|” for Port 1 and “~” for Port 2. 
Using these defaults, if I wish to talk to the station connected to my A stream on Port 
1 I would type “la”. To talk to the station on my C stream of Port 2, I would type “~c”. 


me Fd 
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The STATUS command allows you to see who is on which stream, or the status of the 
stream, i.e. waiting acknowledgment, connect in progress, disconnected. 


If you are connected and not monitoring other packets, the normal headers containing 
the “to” and “from” callsigns will not be shown. The setting of STREAMEYV will then 
determine how often you see the stream designator. This parameter comes defaulted 
OFF, so the stream designators are only shown when a change in streams occurs. 
Turning this command ON will make the stream designators show on every packet. 
Turning STREAMCA ON will also add the callsign of the “from” station beside the 
stream designator. 


Several people talking together present a difficult situation for packet radio since 

the protocol calls for two stations to connect in order to make sure they receive each 
others’ packets. If you wanted to be absolutely sure that everyone got everything you 
said you would have to connect to each person and retype everything to each person. 
That could get a bit cumbersome, so most people use the Unproto Mode and are aware 
that a collision may occur once in a while. You can usually tell by the conversation if 
something was missed, if you don’t get an answer to a question it’s probably not that 
he is ignoring you, but either the question or the answer got collided with. 


With MONITOR ON, the MONLIST command can be used to set up your monitoring 
to see only those you want to see. If you like you may each want to connect to one 
person, then you know at least that one got what was said, but be sure MONMODE 
includes CONNECTED. 


Dwait vs. Persistence and Slottime 


When the TNC acts as a digipeater, packets that need to be relayed are retransmitted 
as soon as the frequency is clear. Because of the end-to-end acknowledgment of these 
kinds of packets it is best for an originating station to avoid colliding with digipeated 
packets. The TNC provides two ways to accomplish this delay. These two methods are 
the standard DWAIT method, or the newer PERSISTENCE/SLOTTIME algorithm. 
During a connect using no digis, this delay also gives the receiving station time to 
switch from transmit to receive. 


Using the DWAIT method, once the TNC detects a clear frequency it will wait DWAIT 
(times 10 milliseconds) time before beginning to key-up the radio to transmit a packet. 
This is a packet originated by you not a digipeated packet. 


The algorithm used with the PERSIST and SLOTTIME parameters helps avoid 
collisions by randomizing the wait time before transmitting. The more random the 
timing the less chance of two TNCs transmitting at the same time and colliding. Once 
the TNC detects a clear frequency it will wait SLOTTIME (times 10 milliseconds). 
Then it will generate a random number. If this number is smaller than the setting of 
PERSIST the TNC will transmit. If it is larger it will wait another SLOTTIME and 
then generate another random number and again decide whether to transmit or not. 
When using PERSIST and SLOTTIME you should set DWAIT to 0. 
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As an example, let’s assume that PERSIST is set to 63, and SLOTTIME is set to 10. 

This value of SLOTTIME results in a random number being generated every 100 

milliseconds. When the TNC sees that the channel is clear, it waits 100 ms, then 

generates a random number between 0 and 255 (inclusive). If, in our example, the 

number was 83, then the TNC would not start the key-up of the transmitter since Gr 
83 is greater than the 63 PERSIST value. Instead, it would wait an additional 100 ms, AG 
and if the channel is still clear, generate a new random number. This time, let’s say it 

comes up with the number 27. Since this is less than the PERSIST value, we now start 

the key-up of the transmitter to send the packet. 


Txdelay 


TXDELAY should be adjusted to allow your radio sufficient time to switch from the 
receive mode to transmit and develop full power output. If the TNC sends the packet 
before the radio is at full power the beginning of the packet will be lost and no one will 
be able to decode it. It is a good idea to allow a little extra time for this parameter to 
allow the station you are talking to sufficient time to switch from his transmit mode 
back to receive. This is not usually necessary if you are connected through a digi- 
peater, but if you are connected direct, this could make the difference between 
successful communications and no communications. The TNC sends flags during this 
period, so if someone has this set extra long you will hear a repetitive sound at the 
beginning of the packet. 


Frack 


Frame acknowledgment time. If the TNC expects an acknowledgment of a packet it 
has sent, it will wait FRACK seconds for the acknowledgment. If the acknowledgment 
is not received it will either send a poll or retransmit the packet, depending on the 
setting of AX25LVL. When digis are used, extra time is allowed for each transmission 
using the following equation: 


FRACK * ((2 * n) + 1) seconds 
where n is the number of digipeaters. 


The FRACK timer begins when PTT is released (the packet has been sent) and is 
suspended when data carrier from the radio is present. 


Retries AX.25 Level 2, Version 1 vs. Version 2 

The way retries are accomplished depends on AX25LVL being 1 or 2. Tb explain 

this we will follow a conversation through its path. First lets assume station “A” is 
connected to station “B” with Version 1 protocol (AX25LVL 1). When station A sends a 
packet to station B, he expects to receive an acknowledge back indicating that station 
B has received the information. In order to verify that the proper packet (or frame) 
has been acknowledged, each frame has a number. This number is sent as a part of 
the frame so the receiving station knows where this packet belongs in the conver- 
sation. The frame numbers range from 0-7 and because of this, we are limited to a 
MAXFRAME of 7 (we do not want the same frame number reused in the same trans- 
mission). This is also true for Version 2. If the first acknowledge is received, there is 
really no difference between the two versions, practically speaking. The difference 
shows up with retries, so let’s assume that the packet did not get through on the first 
attempt. 


PACKET Version 2.0 May 12,1993 Data Engine 
© Copyright 1990-1993, Kantronics Co., Inc. All Rights Reserved. 
1 8 Duplication of this manual or the firmware without permission of Kantronics Co., Inc. is prohibited. 


Let’s now assume that station A sends frame number 3 to station B. Station B does not 
receive the frame and therefore no acknowledge is received by station A. With version 
1, the entire packet is retransmitted (with the same frame number), again to station B 
and this continues until station A receives an acknowledge from station B. This 
acknowledge can take two basic forms. The first time station B receives frame 3 he 
will send an acknowledge of the form “ready to receive frame 4” <rr4>. If this 
acknowledge is sent, and station A did not receive it, station A will again send frame 
3. Since station B already received frame 3, he would acknowledge it with the form 
“I’ve already got frame number 3” <rej4>. This is also known as Reject Frame sent. 
This process would continue until the retry count is exceeded when, under version 1, 
the sending TNC will initiate a disconnect and dump the packet into the air 
UNPROTO. (The monitoring of the commands in < > depends on the settings of 
MONTYPE.) 


Now let’s look at the same conditions under version 2 (AX25LVL 2). Station B does not 
receive the frame and therefore no acknowledge is received by station A. This time, 
station A sends a POLL or question to station B saying, in effect, “did you receive my 
frame number 3?” <<RR3>>. Since station B did not receive the frame, he would 
respond with a “no I did not” <<rr3>>. This really says “I am ready to receive frame 3”. 
At this point, station A, upon receiving the rr3 would immediately resend the entire 
frame. If station B had already received frame 3 once but the acknowledge never got 
to station A the question from station A for the retry would be the same. Station B’s 
response however, would be different. He would respond with “ready to receive frame 
4” <<rr4>>. If station A does not receive station B’s reply this “POLL/REPLY” 
sequence would continue for the number of retries set in the sending TNC and if no 
response was received, the TNC at station A would then begin to issue connect 
requests to station B since there is still an outstanding packet of information. This is 
the major difference between version 1 and version 2. The connect attempts would 
then continue for the number of retries set in the TNC and if no response was received 
from station B after all of the above, station A would disconnect and dump the packet 
UNPROTO. The parameter RELINK can be turned OFF to avoid the reconnect 
attempt. 


In either version 1 or version 2 another interesting feature of packet is the ability to 
automatically reestablish a connection. For instance, station A is connected to station 
B and has one frame outstanding. Station B disconnects without station A knowing it 
(perhaps a power failure, double disconnect or even a timeout (retry count exceeded)). 
The first time station B receives the outstanding packet from station A he will send 

a disconnected message to station A. When station A receives this, station A auto- 
matically issues a connect request to station B and the connection is reestablished to 
pass the outstanding traffic. 


Flow Control 

The flow control commands insure that the TNC gets everything that is sent to it 

by the computer and that the computer gets everything the TNC sends it. When the 
computer sends the TNC data the TNC stores this data in a buffer until it can 
packetize it, send it, and get acknowledgments. When the TNC sends the computer 
data it also stores it in a buffer until it can be processed, stored to disk, sent to printer, 
or whatever. This buffer area is only so big, if more data is sent than will fit in the 
buffer it is lost. To avoid this the two devices can tell each other to start and stop send- 
ing data. This is called Flow Control and can be accomplished in two ways, software 
and hardware. Which way you implement this depends on the capabilities of your 
computer communications program and personal preference. The cable between your 
computer and TNC must also be wired appropriately. 
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Software Flow Control 


Software flow control sends special characters on the Transmit Data (TD) and Receive 
Data (RD) lines of the RS-232 cable. These are the same lines used for sending regular 
data between the TNC and computer. Software flow control normally sends a CTRL-S 
to stop data and a CTRL-Q to restart data. When a buffer gets close to full the device 
will send a CTRL-S and expect the other device to stop. When the buffer gets emptier 
it will send a CTRL-Q to tell the other device to send more data. How full or empty a 
buffer is when the special characters are sent is determined by the program. But, since 
the regular data lines are being used, a CTRL-S sent from the keyboard will also stop 
data. And likewise, if there is a CTRL-S in a file being sent, data flow will stop until a 
CTRL-Q is received. 


FLOWR and FLOWX need to be turned ON for the TNC to use software flow control. 
XOFF determines the character sent by the TNC to stop the flow of data from the 
computer, and the XON character restarts the flow. The TNC expects the computer to 
send the STOP character to stop data and the START character to restart data. To use 
software flow control these commands would be set as follows: FLOWR ON, FLOWX 
ON, XOFF $13, XON $11, STOP $13, START $11. 


In the Transparent Mode two more commands are provided that make it possible to 
send or receive these special characters and still use software flow control. FLOWTX 
controls flow control sent by the TNC to the computer and FLOWTR controls what 
the TNC expects from the computer. If both these commands are ON (and the above 
commands are set as stated) then software flow control will take place in both 
directions, to and from the TNC and computer. But if you are in Transparent Mode 
sending a file the computer is not going to be telling the TNC to stop and start since 
you are sending the file. But if there is a CTRL-S in the file, the TNC will think the 
computer is telling the TNC to stop and will not send any data to your computer until 
it receives a CTRL-Q (even if you have completed sending the file). To solve this 
problem you can turn FLOWTR OFF and send all characters and turn FLOWTX ON 
so the TNC will still tell the computer when to stop and restart. On the other hand, 
if receiving a file set FLOWTR ON and FLOWTX OFF. 


Hardware Flow Control 


Hardware flow control monitors the voltages on the Request To Send (RTS) and Clear 
To Send (CTS) pins of the RS-232 cable. Therefore these two wires must be in the cable 
between your TNC and computer. The TNC holds CTS high as long as it can receive 
data. Once its buffer gets full it pulls this line low. The computer program monitors 
this line and when it is pulled low knows to stop sending data. When the line is again 
pulled high by the TNC the computer program will restart sending data. On the other 
hand the computer holds RTS high as long as it can receive data and pulls it low to tell 
the TNC to stop sending data. The TNC always uses hardware flow control, so only 
wire the RTS and CTS pins if your computer program is also using hardware flow 
control. 
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In the Convers Mode there are many special characters. To list a few: 


Command Default Description 
SENDPAC CTRL-M_ Causes a packet to be packetized 
DELETE CTRL-H Backspace character 


REDISPLAY CTRL-R_ Redisplays the keyboard buffer 
CANLINE CTRL-X Cancels a line 


mn 
PACKET Version 2.0 May 12,1993 Data Engine 

© Copyright 1990-1993, Kantronics Co., Inc. All Rights Reserved. 
20 Duplication of this manual or the firmware without permission of Kantronics Co., Inc. is prohibited. 


STOP CTRL-S Stops output from TNC to computer 
PASS CTRL-V ___ Pass a special character 


These characters are all very useful when having a packet conversation with someone. 
If you want to send a packet you hit the return. If you make a mistake you can backup 
with the delete or backspace key, or kill the whole line with CTRL-X. And if you really 
want to send one of these characters you can always proceed it with a PASS character. 


Transparent Mode is made more for the sending of files, whether they be ASCII data 
files or program files. The special characters do not mean anything to the TNC, they 
are just characters to be put in a packet and sent to the radio. (XOFF, XON, STOP, 
START may be used depending on the settings of FLOWX, FLOWR, FLOWTX and 
FLOWTR, see the flow control section.) ASENDPAC character will not cause a packet 
to be packetized, instead this is controlled by a timer (PACTIME). This way short lines 
do not make short packets, therefore less overhead and more efficient use of the 
frequency. How congested the frequency is should be kept in mind when setting the 
PACLEN and MAXFRAME parameters. 


Besides ignoring special characters, Transparent Mode also ignores the setting of 
MODE. The TNC acts as though MODE is set for parity none, and data bits 8, so be 
sure the computers on both ends of the connection are set the same. All monitor 
commands are treated as OFF in Transparent Mode. All you will see is what is being 
sent to you. You would probably want to set USERS to 1 so no one interferes with the 
transfer. The setting of ECHO is also ignored. Even if ECHO is ON, Transparent Mode 
will not echo to the attached terminal. Some programs allow for local echoing to the 
screen while uploading. 


Getting Out of Transparent 

Getting into the Transparent Mode is easy, you just type a “t” in Command Mode. But 
since Transparent Mode allows the sending of all characters you can not get out of 
Transparent Mode by just typing a CTRL-C (COMMAND character) as in Convers 
Mode. In order to get out of Transparent Mode you must follow a special sequence, or 
use a modem break if your program supports one. The special sequence must be 
followed precisely. This example assumes the COMMAND character is CTRL-C and 
CMDTIME is 1 second: 


e Wait at least 1 second since the last character was sent from the 
computer to the TNC 


¢ Type a CTRL-C 

¢ Within 1 second type a second CTRL-C 

e Within 1 second type a third CTRL-C 

¢ Wait 1 second and the cmd: prompt should appear 


If the guard time of one second before and after the three CTRL-Cs is not there, the 
TNC assumes that they are data and sends them to the radio. Don’t get impatient, 
one second can seem longer than you think it should. 
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PBBS (Personal Mailbox) 


Your Data Engine contains the Kantronics Personal Mailbox system which will allow 
you to leave messages for others which may be retrieved later. The personal mailbox is 
compatible with the large community bulletin board systems (RLI, MBL, etc) and will 
allow them to forward mail for you directly into your Data Engine. You may also place 
messages in your mailbox, and if the local Community BBS system allows, your Data 
Engine mailbox will reverse forward these messages from your personal mailbox into 
the community system on request. The PBBS supports Bulletin IDs (BIDS), Message 
IDs (MIDS) and Hierarchical forwarding designators. 
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When you first enter your callsign into the Data Engine, your PBBS will automatically 
be enabled. The MYPBBS callsign is set to your basic call with an SSID of -1, and the 
PBBS is allocated 5K of RAM. You may change the size of the PBBS using the PBBS 
command. The maximum amount of memory you can allocate will depend on the 
amount of free memory available. NUMNODES, MAXUSERS, and MYREMOTE will 
affect the amount of available memory. 


If you change the size of the mailbox, the TNC will not renumber any existing 
messages, and if the new size is large enough for all existing messages, no messages 
will be lost. If you want to renumber the messages (starting with 1) give the PBBS n 
command with n being the current size. 


At times, you may be away from your computer and would like to switch a user into 
your mailbox automatically if he connects to your MYCALL. This can be accomplished 
by setting the CMSG command to PBBS. When this is done, a user who connects to 
your MYCALL will be sent your CTEXT (if any) and then be automatically connected 
to the PBBS. The TNC will then send the PBBS System ID (SID) and sign on message. 
The SID is enclosed in square brackets and consists of the unit name, firmware 
version, and the supported feature set. For example the Data Engine SID is: 


[DE-2.0-HM$] 


This is the unit name (DE), version number (2.0) and the feature set (HM$). The H 
means it supports Hierarchical forwarding, the M stands for Message ID, and the $ 
indicates BID support. These identifiers are according to the SID definitions published 
by Hank Oredson (WORLI) with his Community BBS system. 


You can customize a greeting message to be sent to a user who connects to your PBBS 
by using the PTEXT command. This command accepts up to 253 characters as a text 
string to be sent to the user immediately after the SID is sent. 


If it becomes necessary to disconnect a station from your PBBS, you can use the local 
terminal connected to your Data Engine to accomplish this (see DISCONNECT 
MYPBBS). If a station connects to your PBBS and no activity occurs on the connection 
for PBTIMER, the PBBS will automatically disconnect the user in order to make your 
PBBS available to others. 


If a community bulletin board forwards messages into your PBBS, it sends you many 
lines beginning with R:. These are routing headers that show the complete path taken 
by this message. By default, these headers will be stored in your PBBS with the 
message. If you choose, you may prevent your PBBS from storing these by setting the 
PBHEADER command OFF. 
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If you want your PBBS to only accept messages for you, you can set the 
PBPERSONAL command ON. When set ON, this command will make your PBBS only 
accept messages that are addressed to your MYCALL or MYPBBS. 


The PBLO command is used to determine the order in which messages are listed to 

a user. When set to OLD, messages will be sent oldest first (message 1, then 2, etc). 
When set to NEW, the most recent message will be listed first. The second parameter 
of this command determines whether or not you will allow a PBBS user to change the 
listing order. When set to FIXED, the user cannot change the order, and when set to 
VARIABLE, the user may change the order by connecting to the PBBS and using the 
LO command. 


Finally, if you desire (or are required) to maintain a log of the stations connecting to 
your PBBS, you may set the PHEARD command. Setting PHEARD n will maintain 
a log of the last n number of stations connecting to your PBBS. The callsign of the 
connecting station will be stored with the date and time of the connect. You can then 
see this log by issuing the PHEARD command with no arguments. 


Using the PBBS 


In order to use any TNC PBBS (even your own) first, get the cmd: prompt on your 
TNC, and then connect to the callsign of the PBBS. For instance, if MYPBBS is 
WK5M-1, I would simply type C WK5M-1. Since the PBBS is in my own TNC, no 
packets would be transmitted, but I would connect to the PBBS and receive the 
same prompt as if I had connected to someone else’s PBBS. 


When you connect to a TNC PBBS, you will first see the message from your TNC 
indicating that you are connected: 


*** CONNECTED to WK5M-1 


The PBBS will then send you its initial sign on message. If you have defined a PTEXT, 
the TNC will send it as the next line, and then it sends the PBBS command prompt. 
Example: 


[DE-2.0-HM$] 

4528 BYTES AVAILABLE 

PTEXT would be here (if any) 

ENTER COMMAND: B.J,K,L,R,S, or Help > 


Using the PBBS is therefore the same, whether you are using your own PBBS or 
another persons PBBS. At this point you are ready to send a message to another user, 
or issue any other mailbox command. 


Let’s assume I want to send a message to KA5ZTX. I would now use the send 
command: 


SP KA5ZTX 
and the TNC responds with: 
SUBJECT: 
I now enter a short subject line: 
Just a quick question 
the TNC responds with: 
ENTER MESSAGE--END WITH CTRL-Z OR /EX ON A SINGLE LINE 
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Now you enter the text of your message. To end the message and have it saved, type 
a <CTRL-Z> (hold down the control key and press Z) or type /EX. The <CTRL-Z> or 
/EX must be on a line by itself — do not type anything else on this line. When the 
message has been ended properly, the PBBS responds with: 


MESSAGE SAVED 
ENTER COMMAND: B,J,K,L,R,S, or Help > 


You may now enter more mailbox commands. The commands available in the TNC 
PBBS are: 

B(ye) 

This command causes the PBBS to disconnect you from the PBBS. 


E(dit) n [BPTYNFH] [>tocall] [<fromcall] [@BBS] [“string1” “string2”] 


This command is only available to the SYSOP (i.e. owner) of the PBBS. It allows you 
to edit the message header of any message in the mailbox, changing the TYPE of 
message: 


B - Bulletin 
P — Private 
T — Traffic 


the STATUS of the message: 


Y — Yes [it has been read] 

N — No [it has not been read] 

F — Forwarded [it has been forwarded] 

H — Held [it is not available for reverse forwarding] 


who the message is to or from: 


>tocall 
<fromcall 


the destination mailbox (@BBS): 
@BBS[.haddr] 
and any string within the message (including subject): 
“string]” “string2” 
Changes the FIRST occurrence of string] to string2, starting with the subject 
of the message. 


If a message is marked as HELD, you can “unhold” it by using the EDIT command 
followed by the number of the message, and the letter H. The letter H acts as a toggle: 
it will hold an unheld message or unhold a held message (e.g. E 2 H). 


When a message is listed, the “tocall” and “fromcal]” appear in the TO and FROM 
columns, respectively. If a message has been entered with an “@BBS” for forwarding, 
the complete hierarchical address is shown when the message is read: 


MSG#2 FROM KA5ZTX TO HELP @WA4EWV.#STX.TX.USA.NOAM 


The @BBS is also listed when using the semi-colon (;) option with any of the list 
commands. 


You can access the Edit command by connecting to the mailbox from the attached 
terminal, or by connecting over the radio. If you connect over the radio, your MYCALL 
must be the same base callsign (excluding SSID) as the MYCALL of the TNC con- 
taining the mailbox, and the FIRST command you give to the mailbox must be SYSOP. 
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When you give the SYSOP command, the PBBS will send you a password verification 
string which must be properly responded to in order to gain SYSOP access. This is 
explained in detail later. 


Let’s say you want to edit message number 2 which currently is a PRIVATE message 
addressed to WOXI. The message has been read by WOXI so it shows a status of Y. It 
may list as: 


MSG# ST SIZE TO FROM DATE SUBJECT 
2 PY 53 WOXI WK5M — 01/14/92 03:36:45 Good afternoon 


Now I want to change this so that it is addressed to WOG@EMR and also change the Y 
flag to N to show that it hasn’t been read. To do this, you connect to your PBBS (either 
from the KEYBOARD or as SYSOP over the radio), and issue the command: 


e 2 N >WDGEMR 
You could do this with two separate commands, or it may be accomplished with the 
single command shown above. 
H(elp) 
This command displays a HELP menu. 


J (heard) 


This command displays a list of stations recently heard by the TNC. The list will 
include a date and time stamp indicating when each station was heard. 


J S(hort) 


This command is similar to the J(heard) command above, but only displays the 
callsigns of the stations heard. 


J L(ong) 


This command is similar to the J(heard) command above, but also displays any 
digipeaters used by the stations it has heard and the destination callsign. 


L(ist) [m [n]] [;] 


This command will list all messages in the mailbox which you are allowed to read. 
This will include all BULLETINS, TRAFFIC, and any PRIVATE messages addressed 
TO you or sent by you. (If you are the SYSOP (keyboard or remote) ALL messages 
will be listed). The optional m and n values are message numbers. If m is specified, 
all allowed messages from m to newest will be listed. If m and n are specified, all 
messages from m to n, inclusive, will be listed. Specifying the optional semi-colon (;) 
in any List command will also show the @BBS and BID of the messages (if any). 


L <I> call [3] 


This command allows you to list only those messages in the mailbox which are 
addressed to a specific callsign (>), or which were sent by a specific callsign (<). To list 
only those messages addressed to AMSAT for instance, you would give the command 
L> AMSAT. 

LB [;] 

This command will list all BULLETINS in the mailbox. 


2 _______._| 
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LC [cat[;]] 


Using the LC command by itself will cause the PBBS to list the TO field of all 

BULLETINS in the mailbox. This will just be a list of the actual TO fields, and not 

a list of the messages. If you specify a category (i.e. LC RACES) the PBBS will list : 
the full message headers of all BULLETINS addressed to that category.  ( 


LLn [3] 


This command will list the most recent n number of messages in the mailbox. Again, 
only BULLETINS, TRAFFIC, and PRIVATE which you are allowed to read will be 
listed. 


LM(ine) [;] 


The LM command will list all messages in the mailbox which are addressed to you. 


LO [+!-] 

This command allows you to change the order in which messages are listed. When set 
to +, the messages are listed in ascending numerical order (oldest to newest). When 
this command is set to -, the messages will be listed starting with the highest message 
number (newest to oldest). This command will not be available if the SYSOP has the 
PBLO command in his TNC set to FIXED. 

LT [3] 

This command will cause the PBBS to list all TRAFFIC messages that are currently 
in the PBBS. 

K(ill) n 


This command will delete message number n from the mailbox. You may only delete i! 
TRAFFIC messages, PRIVATE messages addressed TO or FROM you, or BULLETINS 

you sent. The SYSOP may delete any message, including BULLETINS. 

KM(ine) 


The KM command will delete any messages in the PBBS which are addressed to you 
and that you have read. If you have not read a message addressed to you, it will not 
be deleted. 

R(ead) n 


The Read command is used to read a specific message by number. Only PRIVATE 
messages address TO you, or sent by you, may be read, as well as any BULLETIN 
or TRAFFIC messages. After you read a PRIVATE message addressed to you, the 
STATUS flag will automatically be set to Y — it has been read. 

RM(ine) , 

The RM command will cause the PBBS to display all messages in the PBBS which 
are addressed to you, if you have not already read them. 

S(end) call 

The Send command will send a PRIVATE message to the callsign specified. This is 
the same as using the preferred SP command. 

SB call « 
The SB (Send Bulletin) command is used to send a BULLETIN to the PBBS. 
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SP call 

The SP (Send Private) command will send a PRIVATE message to a specified callsign. 
This is the same as using the Send command. 

ST call 


The ST (Send Traffic) command is used to send NTS type traffic messages to the 
PBBS. 


Some of these commands are described in more detail below. 


Sending Messages 


The SEND command (and its many forms) allows the following syntax: 
S call [@ bbcall[.haddr]] [$ mid] 
SP call [@ bbcall[.haddr]] [$ mid] 
ST zip [@ location[.haddr]] 
SB cat [@ location[.haddr]] [$ bid] 
where: 
call is the callsign of the station the message is addressed to. 


bbcall is the callsign of a full service BBS where the message should be 
delivered. 


haddr is the complete Hierarchical address designator for the BBS system or 
destination of the message. (Contact your local community BBS SYSOP 
for complete information on Hierarchical addressing.) 


location is the designator used for distribution of the message. For TRAFFIC, 
this should be NTSxx where xx is the two letter POSTAL code for the 
state. 


mid is the MESSAGE ID assigned to the message by the originator. 
bid is the BULLETIN ID assigned to the message by the originator. 
zip is the 5 digit postal zip code (or postal code) 


cat is the message category. For instance, a message requesting help on a 
subject may be sent to the category HELP, info sent to INFO, items for sale 
to SALE, etc. Contact your local community BBS SYSOP for some other 
examples and suggestions. 


Some examples of commands would be: 
SP WB5BBW @ W5AC.#STX.TX.USA.NOAM 


this command sends a private message to WB5BBW. The message should be 
sent to the W5AC BBS system, in South Texas (.#STX), which is in Texas (.TX), 
which is in the USA (.USA), which is in North America (.NOAM) where 
WB5BBW< can retrieve it. 


ST 88030 @ NTSNM 


this command sends an NTS traffic message to a non-ham, or to someone who 
is not on packet, living in zip code 88030 which is in New Mexico. The location 
field contains the NTSxx (xx = NM) to indicate that the 88030 zip code is in 
New Mexico. 
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SB RACES @ ALLUS $RACESBUL.010 


this command sends a bulletin addressed to RACES, which should be sent to all 
BBS system in the USA (ALLUS) and has been assigned the Bulletin ID (BID) 
RACESBUL.O10. This BID prevents the same message from being duplicated 
as it travels throughout the BBS system. 


When you send a message to the PBBS, you must include the @BBS (bbcall[.haddr]) 
field if you want the message to be reverse forwarded from the PBBS to a full-service 
BBS system. Any message entered into the PBBS over the radio will initially be 
marked with a status of H (held) and will not be reverse forwarded until the SYSOP 
has edited the message header and changed the H flag. This gives the SYSOP full 
control over the messages relayed by his station. 


Messages entered from the local keyboard connected to the TNC do not require editing 
in order to be reverse forwarded, but must include at least an @BBS field to enable the 
reverse forwarding. 


Listing Messages 


PPP POPE OPI OOP EMM P PIMP OPE OPEL PIPL PEOPLE DMPO PDD, 


When you list messages with any of the LIST commands, you will get a display similar 
to the one shown below. If you specify the optional semi-colon (;) you will also see the 
@BBS field in square braces after the message. 


MSG# ST SIZE TO FROM DATE SUBJECT 

6 Bes45 KEPS WS3IWI 12/19/91 09:37:11 2 Line Element set STS-44 
4 Bawe2G HELP WB5BBW 12/19/91 09:34:05 Xerox 820 

3 Teeics 66044 W@MOUU 12/19/91 09:33:42 QTC 1 Lawrence 913/842 
iz PNe 14 N@APJ WSC 12/19/91 09:33:27 AMTOR 

1 Bies0 ALL WK5M 12/19/91 09:32:49 Need help on AMTOR 
9712 BYTES AVAILABLE 

NEXT MESSAGE NUMBER 7 

ENTER COMMAND: B,J,K,L,R,S, or Help > 


The message number (MSG#) is listed, followed by the STATUS of the message. This 
status includes the message type (B=Bulletin, T=NTS traffic, and P=Personal 
message). The second character in the ST column is the current status of the message. 


A Bulletin status can be: 
F — it has already been forwarded to another full-service BBS 


H — it is being held for review by the SYSOP because it was entered into the 
PBBS over the radio. 


An NTS traffic message (type T) may have a status of H, indicating that it is being 
held for review by the SYSOP before it may be reverse forwarded. 


The type P message (Private) can have the following characters in the second position: 


H — This is a personal message that has an @BBS field but is being held for 
review by the SYSOP before it may be reverse forwarded. 


N — This message is a Personal message that has not been forwarded and has 
not been read by the station it is addressed to. If it is forwarded to a full- 
service BBS, it will automatically be deleted. 


Y — This message has been read by the station it is addressed to, but has not 
been killed. It will not be forwarded even if it has an @BBS since it has 
already been read. 
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Monitoring your PBBS activity 

When a user is in the PBBS, the normal packet monitoring commands will allow 
you to see what the user is sending to the PBBS. This includes MONITOR, 
MONMODE, MONLIST, and LIDLIST. 


Remote SYSOP access to the PBBS 


Using the PBBS over the radio link and editing messages that are already in your 
PBBS can be accomplished by entering the SYSOP command as your first command 
to the PBBS. When you enter this command, you will receive three sets of numbers 
from the PBBS. These numbers indicate the character positions of the RTEXT to be 
used as the password for this log on. 


For instance, let’s say my RTEXT 1s: 
This is a sample rtext. 
Now when I give the SYSOP command, the TNC might respond with: 


Tei 2eSe18a6r9 
pel Oe225.55/018 
13 16 4 9 1 20 


If I choose the first set of numbers, I should send the following as a response: 
Taina 

(T is the 1st letter, ais the 12th letter, i is the 3rd letter, and so on. See the RTEXT 

command in the Commands manual for a more detailed explanation. ) 


NOTE: Spaces DO count as characters, and case is significant! 


Reverse forwarding messages from your mailbox 

The Kantronics TNC mailbox will allow you to enter messages which will be forwarded 
by full-service BBSs (RLI, MBL, etc). These messages have a special format, and can 
be entered in any personal mailbox. Let’s suppose I want to send a message to 
WA4EWV who lives in Texas. I know his home BBS is WB5BBW, so I can put this 
message in the PBBS with the command: 


S WA4EWV @ WB5BBW 


Entering an @ BBS will cause the TNC to reverse forward this message to a full 
service BBS when requested by the full service BBS. In order to improve the chances 
of this message reaching its destination, you should always enter the message with 
complete hierarchical forwarding: 


S WA4EWV @ WB5BBW.#STX.TX.USA.NA 


Complete information on Hierarchical forwarding can be obtained from your local BBS 
system operator, but basically the first field after the @ symbol is the HOME BBS of 
the station you are trying to send a message. The next several fields (separated by 
periods) are the state (two letter postal abbreviation), country, and continent. In this 
case, since Texas is so large, it is sub-divided into smaller areas. These are indicated 
with the # symbol (in this case #STX — South Texas). 
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Messages entered into your mailbox in this format will be reverse forwarded to the full 
service BBS when requested, and the following rules apply: 


The TNC acts like a “smart BBS” when forwarding to or from a full service BBS. This 
means that it will no longer send the SUBJECT: prompt, nor will it send the ENTER 
MESSAGE prompt. You will also notice that when a full-service BBS connects to your 
PBBS, the TNC does not send the usual ENTER COMMAND prompt, but only the > is 
sent. This is designed to reduce the amount of data on the packet network, since 
“smart” BBSs know what is expected of them. 


Once a Private or Traffic message has been successfully forwarded out of your mailbox, 
it will be deleted from the PBBS. Bulletins will be marked with a status of “F” and will 
remain in the PBBS. 


Forwarding messages from your PBBS 


Your Data Engine PBBS is capable of initiating a forward to another BBS system 
automatically. To set up your PBBS to do this, use the PBFORWARD command and 
specify the callsign of the BBS you will forward to, any required digipeaters, and the 
time interval between forwarding attempts. 


Setting the time interval to “AFTER n” will cause the PBBS to attempt to forward any 
eligible messages as soon as a user disconnects from the mailbox, and every n hours 
after that. Setting the interval to “EVERY n” will result in a forwarding attempt every 
n hours after you set the interval. 


A message in the PBBS is eligible for forwarding if it contains an @BBS field, has not 
been forwarded or read (STATUS shows F or Y) and is not addressed TO or @ your 
MYCALL or MYPBBS call. 


ge A SS A RR 2 RA ES A ESE RS 5 NDS SS SS AES SY ARMS SS 
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The Kantronics KA-Node is a part of your Data Engine, which provides users with 
local acknowledgments of packets, rather than the end-to-end acknowledgments 
required when connecting to distant stations with digipeaters. This feature is useful 
when connecting to distant stations, and generally results in a significant increase in 
data throughput. If you connect to a dual-port Kantronics KA-Node (in a Data Engine, 
KAM or KPC-4), you may also “gateway” from one port to the other using the 
commands described under “Using a KA-Node”. This would allow a VHF user to access 
HF packet frequencies by using such a KA-Node. Each packet you send to a KA-Node 
is acknowledged by that KA-Node and also passed to the next station in the path. 
Since the data has been acknowledged from your station, any retries which are 
required due to collisions or other conditions will be automatically performed by the 
KA-Node. 


Frequently when connecting to a distant city, you may wish to talk to more than one 
station. Perhaps when you connected, you got a message saying “I’m not here right 
now, please leave a message in my PBBS”. By using the “S(tay)” option when telling a 
KA-Node to connect to another station, the KA-Node will not disconnect from you if it 
receives a disconnect from the distant station. Instead, you will receive a message 
from the KA-Node saying “###DISCONNECTED BY (call) AT NODE (MYNODE)”. In 
other words, if I connected from Lawrence, Kansas to a KA-Node in Lincoln, Nebraska, 
and then told that KA-Node to connect to someone using the command “C call Stay”. 
Then if that station sent me the above message and disconnected, I would remain 
connected to the KA-Node in Lincoln! This now would allow me to issue a connect 
directly to his BBS, without having to re-establish the entire path. 


In multiple KA-Node paths, each time you say B(ye) to the distant KA-Node, this 
would return you to the next previous KA-Node which had been told to “Stay” in the 
chain of KA-Nodes. From that point, you could build a path in a different direction. 
One point to note here, is that if you use the KA-Node to connect to a BBS (WORLI 
or WA7MBL for instance), and use the STAY option, then say B(ye) to the BBS, you 
would remain connected to the KA-Node closest to the BBS. If you issue the connect 
without the STAY option, any disconnect from either end will cause the entire link 
to disconnect. 


The KA-Node checks the passage of data through the node, and if no activity occurs 
for some preselected time (see KNTIMER) then the KA-Node will disconnect both 
sides of the node. 


Configuring Your KA-Node 

In order to set your Kantronics TNC for use as a KA-Node several conditions 

must be met. First, you must allocate the number of circuits you wish to allow through 
the KA-Node (see NUMNODES). Each circuit consists of an “IN” and an “OUT” side. 
Secondly, the callsign assigned to the KA-Node (MYNODE) must be different from 

the callsign used for you (MYCALL), your alias (MYALIAS), the PBBS (MYPBBS), the 
gateway (MYGATE), and remote access (MYREMOTE). By default, your TNC has set 
MYNODE to your callsign with an SSID of -7. To allow users to cross-connect, you 
must set KNXCON ON and have the PORT command set for two ports. 
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If you would like your node to appear in the node list of other KA-Nodes, you must set 
your ITEXT to contain your MYNODE callsign followed by /N on the first line. For 
instance: 


ITEXT WOXI-7/N 


If desired, you may set the NDWILD command ON. This will cause your KA-Node 

to accept a connect request to any SSID of the MYNODE callsign, except those 
mentioned above. Packets passing through your KA-Node are monitored unless your 
MYNODE callsign is excluded by the MONLIST. The NHEARD command sets the 
maximum number of nodes that will be listed when the nodes list is requested. If it 
becomes necessary to disconnect a station from your KA-Node, you can issue the 
command DISCONNECT MYNODE, from the local terminal connected to your TNC 


Each KA-Node circuit allowed will require some memory, with a maximum of 26 
circuits. If you attempt to set NUMNODES to a value requiring more memory than 
available, you will receive a message indicating that the value is out of range or not 
enough RAM. The total number of circuits which may be allocated will also be affected 
by the amount of memory allocated to the Personal Mailbox. 


To use the KA-Node as a means of connecting to some other node or end-user, you 
must first connect to the KA-Node. At the cmd: prompt on your TNC, issue a connect 
request to the callsign of the KA-Node, let’s say LAW. When you make connection you 
will see the following messages on your display: 


*** CONNECTED TO LAW 
### CONNECTED TO WILD NODE LAW (WD@EMR) CHANNELA 
ENTER COMMAND B,C,J,N,X, or Help ? 


The *** CONNECTED message is sent by your local TNC to the terminal, and the 
### CONNECTED TO NODE message is coming from the distant KA-Node. 
WD@EMR is the MYCALL of the station containing the KA-Node in this example, 
WILD indicates that he is running a “wildcard” node, and CHANNEL A indicates that 
you have connected to its channel A. If A is in use, you may obtain channel B. The 
channels, or circuits, are assigned by the KA-Node as needed. 


After connecting to the KA-Node, you are in CONVERS mode at your own station, but 
the KA-Node is waiting for a command. You issue a command to the node by STAYING 
IN CONVERS MODE. The KA-Node will interpret the data you send as its commands. 
It can receive only commands; it doesn’t know what data is. At this point, let’s assume 
that you wish to know what other KA-Nodes are nearby. You would issue the NODES 
command by typing N, or NODES, in response to the KA-Node “enter command” 
prompt. You will receive a list of KA-Nodes which have recently been heard. For 
example, let’s suppose that KC was heard by LAW. Your list received from the Nodes 
command would be: 


KC (N@APJ-2) 12/23/87 02:38:45 
ENTER COMMAND B,C,J,N,X, or Help ? 
KC denotes the KA-Node callsign, the MYCALL of the KA-Node station is in 


parentheses, followed by date and time heard. If LAW had heard nothing, it would 
respond with: 


NO KNOWN NODES 


cca, 
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ats, 


You may, instead, wish to know what other stations the KA-Node has heard lately. 
This would be accomplished by sending the JHEARD command. The node will respond 
by listing its own MHEARD log. The list will contain end user and node callsigns and 
is the same type of list you get by using your own MHEARD command at the cmd: 
prompt. 


At this point, let’s suppose that you would like to connect to the node called KC 
through your current connection with LAW. Just issue a connect request to KC as 
follows in response to the “enter command” from LAW: 


CONNECT KC 
The response will be: 


###LINK MADE 
###CONNECTED TO NODE KC (MYCALLSIGN OF KC) CHANNEL A 
ENTER COMMAND B,C,J,N,X, or Help ? 


Now you are “patched” through the KA-Node LAW to the node KC. When LAW issued 
the connect request to KC it used your own call but subtracted a count of one from 
your SSID. For example, if you connected to LAW with W@XI, LAW connected (via 
your request) to KC with W@XI-15. This is automatic. You could now connect to 
another KA-Node, some other network node using AX.25 as an uplink or downlink 
protocol, or to an end-user. Let’s assume that you desire to connect to NOAPu. So, just 
enter in response to the node “enter command” above: 


C NOAPJ Stay 
and you'll get the response: 
###LINK MADE 


You are now connected to NOAPJ. If you have issued a connect command to a 
KA-Node, and realize that you have made a mistake with the call, or for any other 
reason wish to cancel the connection, you may do so by using the ABORT command. 
In order for the abort to work, it MUST be the first word entered following the connect 
command and must be spelled out entirely. For instance if you tell the KA-Node: 


XC KB5EEG 
and then decide to abort the connect, your next entry must be: 
ABORT 


any other entry will cancel any possible abort of the connection, and you must wait for 
the KA-Node to retry out. 


Now that you are connected to NOAPJ, you can carry on a normal packet QSO. While 
everything appears “normal” and AX.25 compatible, acknowledgments to your packets 
are generated by the KA-Node directly connected to you. Each channel in the link 
takes care of its own errors. In other words, the link between KC and LAW handles its 
own error checking. In this way, one weak link will not cause end-to-end packets and 
acknowledgments to be repeated as they would with digipeating. The result is 
substantial improvement in throughput for connections using nodes. 


When it comes time to disconnect, you do so in the standard AX.25 manner. To 
disconnect the link described above, type <CTRL-C>, obtain the cmd: prompt on your 
TNC, and issue the disconnect command: 


cmd: D 

*** DISCONNECTED 
nen nn ee 
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You'll get the usual disconnect message from your TNC as noted. If however, your 
distant partner, in this case N@APu, disconnects the link, you'll see the following: 


###DISCONNECTED BY N@APJ AT NODE KC 
ENTER COMMAND B,C,J,N,X, or Help ? 


Automatic Disconnect 

If a user abandons a connection to a KA-Node or a link between two KA-Nodes without 
disconnecting and there is no activity through the link for a specified period of time 
(see KNTIMER), the node will initiate a disconnect. 


Using the XCONNECT Command 
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(Data Engine, KAM and KPC-4 only) 


The cross-connect (XCONNECT) command is a unique feature of the KA-Node. This 
command allows cross linking between two frequencies through the node in much the 
same manner as the Kantronics unique gateway, but with local acknowledgment of 
packets. 


For example, suppose you just connected to node LAWKAN and wish to cross-connect 
to WD@EMR whose station is tuned to the frequency of the other port of the node. 
Just issue XC WD@EMR following the the node prompt: 


ENTER COMMAND B,C,J,N,X, or Help ? 
XC WD@ZEMR <CR> 


The response you receive will be: 


### LINK MADE 
### CONNECTED TO WD®EMR 


You can also determine from the response to the NODE command, which port a node is 
on. Below is an illustration of a Data Engine KA-Node response to a NODE command: 


this port 
KSLAW (WK5M-1) 17/AUG/92 14:57:36 
cross port 
KSTPK (K@VAY-1) 17/AUG/92 14:53:06 


In this illustration, the alias of the node is given, followed by the callsign of the node 
and the date and time it was last heard. To connect to nodes listed under “cross port”, 
you must use the XCONNECT command. 


The KAM and KPC-4 response to a NODE command is different: 


LAWKAN* — 12/02/87 15:45:00 
N66046/X 12/02/87 15:49:15 
OLAKAN/X = 12/02/87 16:15:21 


In this display the callsign of the node is given, followed by the date and time it was 
last heard. The slant bar X (/X) indicates that the node was heard on the opposite port 
from the one you are connected on. The asterisk (*) means that the node was heard 
via a digipeater. 
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Determining Which Port You Have Connected To 


The JHEARD command of the KA-Node will tell you who has been seen and on which 
port. If a Data Engine is set for only one port (PORT 0), the response to the JHEARD 
command will be a list of stations heard on that port. Following is an example of a 
response to the JHEARD command from a Data Engine that is set for two ports 
(PORT 1 or PORT 2) 


this port 

WK5M-1 17/AUG/92 15:27:16 
WMSU * 17/AUG/92 15:29:04 
WD@EMR © 17/AUG/92 15:32:23 


cross port 
K@KU-1 17/AUG/92 15:20:30 
K@VAY 17/AUG/92 15:28:06 


You are connected on the port whose list is under the “this port” heading. The asterisk 
after WMQU indicates that station was heard via a digipeater. If you wish to connect 
to any stations under the “cross port” heading, you must use the XCONNECT 
command. 


When you are connected to a KPC-4 or KAM node, you can determine which port you 
are on, at the node, by using the JHEARD command. A typical node response to the 
JHEARD command may appear on your display as shown (the KAM uses /H and/V 
instead of /1 and /2): 


N66046/2* 12/01/87 14:32:69 
WK5M-1/1 — 12/01/87 16:25:01 
WOXI/2 12/02/87 16:28:05 
WD@®EMR/1 12/02/87 16:32:09 


In this illustration the number following the slant bar (/) indicates the port the station 
was heard on. Your callsign will usually be the last one in this hist. 


You can now see that by comparing the port on which your call appears in the 
JHEARD list to the port indicated for other stations, you can determine whether to 
CONNECT or XCONNECT to the station of your choice. 


KA-Node Commands for Remote Use 


When accessed by radio, the KA-Node has several commands which may be given to it. 
These commands are listed here for reference, with a description of each command. In 
these descriptions, the UPPER case characters of the command are required. LOWER 
case characters are optional. Those items listed within [ ] are optional and if used the 
UPPER/LOWER case convention listed above applies. 


ABORT 


This command will abort a KA-Node Connect or XCONNECT request if it is the first 
data sent after the request. It must be spelled out entirely. 


Bye 
This command will cause the KA-Node to initiate a disconnect. 
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Connect callsign [Stay] 


This command will cause the node to issue a connect request to “callsign” in the usual 
AX.25 mode. If the connect is successful, a link will be made to the next node or end- 
user station. The optional Stay feature provides a way to disconnect without loosing 
the entire link. Normally when a disconnect occurs, whether issued by you or by the 
remote station, the connection to the KA-Node is also lost. Using the Stay option 
allows you to stay connected to the KA-Node when the remote station issues a 
disconnect. 


Help 

This command causes the KA-Node to send a brief help list, showing all commands 
available, with the options and a short description of each command. 

Jheard [Short! Long] 


This command will cause the KA-Node to transmit its TNC MHEARD log. The 
returned list (without the short or long option) will look like this: 


(Data Engine) 
this port 
WK5M-1 17/AUG/92 15:27:16 
WM9U * 17/AUG/92 15:29:04 


WDMEMR = 17/AUG/92 15:32:23 
cross port 
K@KU-1 17/AUG/92 15:20:30 
K@VAY 17/AUG/92 15:28:06 
(KAM) (KPC-4) 


LAWKAN/H* 01/09/88 08:25:15 
N66046/V 01/10/88 00:03:10 
WK5M-3/H 01/10/88 00:03:19 
WD@EMR/V 01/10/88 00:04:15 


LAWKAN/1* 01/09/88 08:25:15 
N66046/2 01/10/88 00:03:10 
WK5M-3/1 01/10/88 00:03:19 
WD®EMR/2 01/10/88 00:04:15 


(KPC-1, 2 or 2400) 


LAWKAN 01/09/88 08:25:15 
N66046* 01/10/88 00:03:10 
WK5M-3 01/10/88 00:03:19 
WD@EMR 01/10/88 00:04:15 


The left column indicates the callsign (and SSID if appropriate) of a station heard. The 
character following the slant bar (/) shows the port on which the station was heard, if 
both ports are active. The asterisk indicates the station was heard via a digipeater. 
The center and right columns indicate date and time the station was last heard. The 
last call on the list will probably be your call. The above JHEARD lists show 
WD@EMR connecting to the KA-Node and requesting the node’s JHEARD log. 
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The short (SHEARD S) version of this command would produce the following list: 
(Data Engine) 


this port 
WK5M-1 
WM®U* 
WD®@EMR 


cross port 
K@KU-1 
K@VAY 


(KAM) (KPC-4) (KPC-1, 2 or 2400) 


LAWKAN/H* LAWKAN/1* LAWKAN 
N66046/V N66046/2 N66046* 
WK5M-3/H WK5M-3/1 WK5M-3 
WDMEMR/V WD®EMR/2 WDGMEMR 


The long (JHEARD L) version of this command will also show the destination field and 
the digipeaters used. This list would look like: 


(Data Engine) 
this port 
WK5M-1 >ID 17/AUG/92 15:27:16 
WM®#U >BEACON 17/AUG/92 15:29:04 
via *KSTPK,KSBLC 
WD@EMR >KA5ZTX 17/AUG/92 15:32:23 
cross port 
KMKU-1 >ID 17/AUG/92 15:20:30 
K@VAY >BEACON 17/AUG/92 15:28:06 
(KAM) 


LAWKAN/H* > WOXI 01/09/88 08:25:15 
VIA KSKU, TOP*, KSKU 

N66046/V. >BEACON 01/10/88 00:03:10 

WK5M-3/H* > WD@EMR 01/10/88 00:03:19 
VIA WX], TOP* 

WD@EMR/V > KC _ 01/10/88 00:04:15 
VIA KSTOP, KCMO 


(KPC-4) 


LAWKAN/1* > WOXI 01/09/88 08:25:15 
VIA KSKU, TOP*, KSKU 

N66046/2 > BEACON 01/10/88 00:03:10 

WK5M-3/1* > WD@EMR 01/10/88 00:03:19 
VIA W@XI, TOP* 

WD@®EMR/2 > KC 01/10/88 00:04:15 
VIA KSTOP, KCMO 


(KPC-1, 2 or 2400) 


LAWKAN* > W&XI 01/09/88 08:25:15 
VIA KSKU, TOP*, KSKU 

N66046 > BEACON 01/10/88 00:03:10 

WK5M-3* > WD@®EMR 01/10/88 00:03:19 
VIA W@Xx]I, TOP* 

WD@EMR- »>KC _ 01/10/88 00:04:15 
VIA KSTOP, KCMO 
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Nodes [Short! Long] 

This command will cause the node to return a list of KA-Nodes it has heard, as well as 
Net/Rom, TheNet, or G3BPQ Packet Switch nodes. The format of the list is similar to 
that of the JHEARD list above. 


XConnect callsign (Data Engine, KAM and KPC-4 only) 


This command will cause the node to issue a connect request to “callsign” (in the usual 
AX.25 format) on the opposite port of the KA-Node. Cross-connecting enables you to 
gain access, via the node, to another frequency. 
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Remote Access to Your Data Engine 
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Your Kantronics Data Engine includes the ability to connect from a remote station 
and change the parameters in the Data Engine. This allows you to add or delete 
stations from the LIDLIST, change the size of the PBBS, change the MYCALL and so 
on. Extreme caution must be used when you are accessing your Data Engine from a 
remote location. There is no built-in safeguard, and as such it is possible for you to 
change parameters such that the remote Data Engine will no longer communicate. 


In order to change parameters in a remote Data Engine, the RTEXT in the remote 
Data Engine must be set to a text string that will be used as the password string. For 
instance, you might set your RTEXT to: 


RTEXT This system belongs to WOABC in Lawrence, Kansas 66046 


The remote Data Engine must also have its MYREMOTE set to a unique callsign 
(i.e. WOABC-4, or XYZREM). If these two parameters are not set as indicated, remote 
access to the command set of this Data Engine is not possible. 


When these parameters are set, you can connect to the MYREMOTE callsign of the 
remote Data Engine. The MYCALL in your TNC must match the MYCALL of the 
remote Data Engine (excluding SSID). In the example above, the MYCALL callsign of 
the Data Engine I want to change is set to W@ABC and the MYREMOTE is XYZREM, 
so the callsign of the connecting station must be WOABC-x (x = any SSID). 


cmd: CONNECT XYZREM 


Your Remote 
Station Station 


MYCALL WMABC-x MYCALL W@ABC 
MYREMOTE XYZREM 


RTEXT This system belongs to 
x = any SSID W@ABC in Lawrence, Kansas 
(but different in each TNC) 66046 


When the connection is made, the remote Data Engine will send three lines of 
numbers. The numbers would look like: 


Gee Ons 3556518373 
Biola o1 45-28 19 
SRe? Oe BRD Ze 22a) 


You must then pick ONE of these lines and decode the password string. Let’s say I 
choose to decode line 3 (48 26 8 52 22 1). Rewriting my RTEXT string to make this 
easier I would have: 


1 2 3 4 5 
123456789012345678901234567890123456789012345678901234 
This system belongs to WZABC in Lawrence, Kansas 66046 


To decode the string, character 48 is “s”, character 26 is “A”, character 8 is “s”, 
character 52 is “O”, character 22 is “o”, and character 1 is “T”. I must send the 
following in response to my remote access attempt: 


sAsOoT 
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Note that case is significant and spaces are considered valid characters. If you fail to 
properly decode the password, the Data Engine will send three new lines of numbers. 
You will be given a maximum of three attempts to properly decode the password 
string. If you fail in three attempts, the Data Engine will disconnect you and disable 
connects to the MYREMOTE for 15 minutes. Also, if you connect to the MYREMOTE 
and start the password sequence but then disconnect, the penalty timer is in effect for 
15 minutes. 


Be careful when using the remote access feature. You can change ANY command in 
the Data Engine without restriction, but this can lead to problems. For instance, if 
you change the INTERFACE command to KISS and then send a RESET command, 
the remote Data Engine will be placed into the KISS mode and will completely quit 
talking to the radio! Also, if you connect to the MYREMOTE of a Data Engine and 
then issue a command like CONNECT W1ABC, the remote Data Engine will indeed 
connect to the station, but there will be no data sent to you from that connection. The 
connected data would be sent to the serial port of that remote Data Engine. We urge 
EXTREME caution when using the remote access! Note also that any command that 
causes a reset (i.e. NUMNODES, PBBS, MAXUSERS) will disconnect all current users 
(PBBS, NODE, and YOU). 


REMOTE ACCESS Version 2.0 May 12,1993 Data Engine 
© Copyright 1990-1993, Kantronics Co., Inc. All Rights Reserved. 
40 Duplication of this manual or the firmware without permission of Kantronics Co., Inc. is prohibited. 


LILLE ELODIE EEE EEL OEE EEE AOE EAL ARAL ELPA A PELE ALE EAA APE EEE EAAL AE AEA AEE EA AAA ALLA AEE LEE AA EEL ELE A 


In order to operate in the Host Mode with the Kantronics Data Engine, you must first 
set the INTERFACE command to HOST. After this is accomplished, it will be neces- 
sary to perform a soft reset in order to enter the Host Mode. This may be accomplished 
by typing RESET at the cmd: prompt. If the MODE command is set to 0, the Data 
Engine will run its autobaud routine, looking for an asterisk (*) from the keyboard. 
When the asterisk is entered, the Data Engine will then immediately enter Host 
Mode. While operating Host Mode, your program must use hardware flow control 
(RTS/CTS). Software flow control is not possible in Host Mode. 


Communications Format 


Host computer to Data Engine 


The communications from the host to the Data Engine must occur in blocks. The block 
of data is delimited with a FEND character at beginning and end ($C0). If the FEND 
character appears within the block, the host must replace this character with a special 
sequence, consisting of a FESC ($DB) followed by a TFEND ($DC). One other special 
sequence may be required in the event a FESC ($DB) character is required in the data 
field. This is accomplished by the special sequence of a FESC ($DB) followed by a 
TFESC ($DD). These special sequences are the same used in the KISS code, as 
implemented by Phil Karn, KA9Q. 


The next character is the command byte and will indicate the type of command being 
given to the Data Engine. The permissible characters in the command byte are C, D, 
or Q. A ‘C’ indicates a command which the Data Engine will interpret as if it were in 
the Command Mode. If the command byte is a ‘D’, the Data Engine will consider the 
data as data to be transmitted on the specified port and stream. The letter ‘Q’ in the 
command byte will cause the Data Engine to exit the Host Mode and return to 
Terminal Mode. 


The next byte is the port byte. This byte must be used with every block of type “‘D’ to 
signify which port, 1 or 2, is to be used for transmission of the data. Type ‘C’ blocks 
must always specify this byte as either a 1 or 2, but this is only used on those 
commands which are specific to a port. This would include the CONNECT and 
DISCONNECT commands. 


The fourth byte is the stream byte. This byte determines which stream (A-Z) the Data 
Engine will use for the data. If the stream byte is 0 for a data packet (command byte 
D), the data will be sent out UNPROTO. For commands that do not involve a specific 
port or stream, the port and stream bytes are ignored, but must be specified. In these 
cases, you should address port 1 and stream A. 


After these four header bytes, the structure of the block for a command is exactly 
the same as if you were entering the command from the Terminal Mode of the Data 
Engine. If entering data to be transmitted, simply place the data in the following 
bytes. 

After the data or command, terminate the information from the host with a FEND 
($CO) character. 


Data Engine to Host Computer 


Communications from the Data Engine to the host also occurs in blocks, which are 
delimited at beginning and end with FEND characters ($C0). 
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After the beginning FEND, the next character is the status byte. A status byte ‘C’ is a 
response to a command from the host with the command byte ‘C’. A status byte of “D’ 
indicates that the data was received on a connected stream. ‘M’ in the status byte 
means that the data in this block is the result of the monitor commands. 


A status byte of ‘S’ is a status message caused by a change in the link state. Such 
messages include the *** CONNECTED TO, *** DISCONNECTED, and FRMR sent: 
types of messages. A special ‘S’ block of data consists of two FEND characters, the 
characters S00 and another FEND character. This indicates that the Data Engine 
has performed a soft reset, and all existing connections (if any) are no longer valid. 
This is equivalent to the Data Engine having just been turned on. A data block 

with the status byte ‘R’ is a *** CONNECT REQUEST. A block with a status byte “T” 
is the result of the TRACE command. Port and stream bytes (defined below) are valid 
for ‘D’ and ‘S’ blocks, but only the port byte is valid for “T’, ‘M’ and ‘R’ blocks. 


The port byte follows the status byte, and will contain the port number the specific 
information is from. This will be a ‘1’ if the Data Engine is in single port operation, 
or a ‘l’ or ‘2’ if in dual-port operation. 

The stream byte follows the port byte. The stream byte will be ‘A’ - ‘Z’ for data on 
connected streams. Data being sent to the host which is not connected data, will have 
the stream byte set to ‘0’. 


If the Data Engine returns a ‘C’ status block with no data, this indicates that the 
command was accepted. This will occur on connect and disconnect commands. 


A ‘T’ block from the host (TRACE information) is raw data, and not a hex dump of 
the received packet. 


The KISS transparency (FESC, FEND, TFEND, TFESC) described above is always 
applied to all blocks. 


HOST Version 2.0 May 12,1993 Data Engine 
© Copyright 1990-1993, Kantronics Co., Inc. All Rights Reserved. 
42 Duplication of this manual or the firmware without permission of Kantronics Co., Inc. is prohibited. 


KISS Mode 
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The KISS Mode allows the Data Engine to act as a modem and packet assembler/ 
disassembler (PAD). The heart of the work to be done concerning what happens to 
data must reside in your computer in order to use this mode of operation. The KISS 
code as designed by Phil Karn is implemented to support higher level protocols for 
sharing computer resources in a network fashion. 


The most popular program using the KISS Mode of operation is TCP/IP or Transport 
Control Protocol/Internet Protocol. This program will allow simultaneous file transfers 
using FTP (File Transfer Protocol), user conversations using TELNET, and a Simple 
Mail Transfer Protocol (SMTP). In addition, multi-connect capability is built into the 
package, with the data being displayed only for the current “session”. You can relate a 
session to an I/O stream in the normal TNC operating mode. 


In the KISS Mode, the TNC simply passes all received data to your computer, and the 
computer program is responsible for all processing of that data, including decisions 
concerning routing, digipeating, and other control decisions. The TNC converts the 
synchronous data being received from the radio link into asynchronous data to be 
passed to the computer over the serial port, and converts the asynchronous data from 
your computer into the synchronous format suitable for radio transmission. The TNC 
retains the responsibility for these functions, as well as determining proper timing for 
channel access. 


In the KISS Mode, channel access is determined by two settings in your TNC — 
namely PERSIST and SLOTTIME. The algorithm used to determine whether or not 

to transmit using this method has been shown to be considerably more sophisticated 
than the DWAIT method used by most standard AX.25 packet stations. The result 

of using the persistence algorithm is increased throughput under most channel 
conditions. For our explanation of this algorithm, let’s assume a PERSIST setting of 63 
and a SLOTTIME setting of 10. This slottime setting corresponds to 100 milliseconds. 


When the TNC detects that the channel is clear and available (no carrier is detected), 
it starts a timer (SLOTTIME). When the timer expires (100 ms in our case) the TNC 
generates a random number between 0 and 255. If the generated number is equal to 
or less than the PERSIST value, the TNC keys up the transmitter and sends the data 
packet. With our setting of 63 the odds of this occurring after the first slottime are 
about 1 in 4. (Actually the odds are PERSIST plus 1 divided by 256.) If the TNC 
generated random number is greater than PERSIST, the TNC restarts the timer and 
waits for the timer to expire again before generating a new random number. This is 
repeated until the TNC gains channel access and sends its packet of information. 


By carefully examining what happens, we can see that making SLOTTIME smaller 
will cause the TNC to generate the random number more frequently, whereas raising 
the PERSIST value will give a better chance (improve the odds) of transmitting the 
data. Through careful choice of these values, it is possible to improve data throughput 
while at the same time permitting shared channel usage by other packet users. 


Data received from the radio is converted into asynchronous format by the TNC and 
sent to your computer. The data actually sent over the serial port is formatted with 
special control information, allowing the TNC to determine the type of data being 
received from the TNC. 


LL 
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Let’s look at data from the TNC to the computer. First, all information flowing in this 
direction is data. No special messages are sent from the TNC to the computer in KISS 
Mode. The only data flowing in this direction is that received through the radio link. 
Every “frame” of data sent from the TNC will begin and end with a special FEND 
character. This character is the ASCII code $CO (hex) or 192 decimal. The second byte 
of the data will be the data type, and will always be a $00. This means that the 
following information is data. If the data actually contains the FEND character ($C0O) 
it will be necessary to tell the computer that the $CO0 it receives is not the end of the 
frame, but simply is more data. This is accomplished by replacing the $CO character 
with a special sequence consisting of a FESC ($DB) followed by a TFEND character 
($DC). One final special sequence which could be sent from the TNC to the computer is 
a FESC ($DB) followed by TFESC ($DD). This is translated into $DB by the computer 
program. 


Now, looking at data flowing in the other direction, that is from the computer to the 
TNC. There are five possible commands that you may need to issue to the TNC from 
the computer, and they basically concern setup parameters. These are commands 
needed to set TXDELAY, PERSISTENCE, SLOTTIME, and finally, a command to exit 
the KISS Mode of operation. The only other data which the computer may send to the 
TNC in KISS Mode is data which is to be transmitted over the radio (HDLC) channel. 
The data coming from the computer must also begin and end with the same FEND 
character as is used for data coming from the TNC. All special character sequences 
must also be used to send the FEND, and FESC characters as data. 


Each of the commands is assigned a command type number as follows: 
TYPE FUNCTION 


0 Data to be transmitted 

1 TXDELAY — second byte contains txdelay in 10 ms increments 
2 PERSISTENCE - second byte contains persistence value 

3 SLOTTIME - second byte contains slot interval 


Bele KISS — causes exit from KISS Mode 


For example, if I want to set the TXDELAY in my KISS Mode TNC to 100 
milliseconds, the computer would send the following bytes to the TNC: 


CO 01 0A CO 
and to send a data packet saying hello would be: 
CO 00 68 65 6C 6C 6F CO 


It is important to note that this data packet does not contain any addressing 
information, and therefore cannot be sent via AX.25 protocol. All of the addressing 
and formatting of the addresses must be done in the computer and sent as a data 
packet to the TNC. 


One final sequence of value (particularly for PC compatible users) is the “Leave KISS 
Mode” sequence: 


CO FF CO 


If for some reason, you have INTERFACE KISS, when you turn the unit off and then 
on again you will be in KISS Mode. The only way to leave this would be to perform a 
hard reset, or use the TCP/IP command to leave KISS Mode, or to send the CO FF CO 
sequence from your keyboard. The PC compatibles offer this last opportunity by 
following this sequence: 


e Press and HOLD the ALT key. Type the numbers 192 from the numeric 
KEYPAD — Not the keyboard. Release the ALT key. 


LL 
KISS Version 2.0 May 12,1993 Data Engine 

© Copyright 1990-1993, Kantronics Co., Inc. All Rights Reserved. 
44 Duplication of this manual or the firmware without permission of Kantronics Co., Inc. is prohibited. 


e Press and HOLD the ALT key. Type the numbers 255 from the numeric 
KEYPAD — Not the keyboard. Release the ALT key. 


e Press and HOLD the ALT key. Type the numbers 192 from the numeric 
KEYPAD -— Not the keyboard. Release the ALT key. 


Now if the terminal program you are using sent all those characters, you will be out 
of the KISS Mode. Remember to change the INTERFACE command if you do not want 
your TNC to be in KISS Mode when you turn the unit off and then back on. 


The Data Engine is capable of supporting dual-port KISS mode operation. This is 
accomplished by using the high nibble (4 bits) of the command byte to indicate which 
port to use. A non-zero high nibble, with the low nibble being the previously defined 
TYPE, will address Port 2, while a zero high nibble will address Port 1. 


re nn SS SS ES EE SSDS ELS 
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Introduction to Commands = ————<“‘i‘Ctwts 
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There are many commands which affect operation of the Kantronics Data Engine. 
Some commands affect performance under specific conditions, some change 
parameters affecting general operation and others direct a one-time action. 


The user changes parameters and issues instructions to the TNC by typing commands 
composed of English-like word abbreviations and variables which are numbers or 
strings of characters chosen by the user. You will probably never change some of these 
parameters. 


Default values are stored in EPROM, and are the settings used at power-on. If you 

change any setting or value, the new setting or value will be stored and will be the 

value used at future power-on. You can restore the factory defaults by performing a 
hard reset or by using the RESTORE DEFAULTS command. 


@® Entry 


A command is entered to the Data Engine by typing the command name and its 
argument (setting or value) in the Command Mode. The prompt for Command Mode is: 


cmd: 


The command and argument must be separated by a space, and the Data Engine takes 
action when a carriage return <CR> is typed. All command entries may be abbreviated 
to the shortest unique string. In the command list which follows, those required 
entries are denoted by capital letters. 


You can examine the value of any parameter by typing the command name followed by 
a <CR>. A special command, DISPLAY, allows you to see the values of all parameters 
or groups of related parameters. 


Once you go into Packet Convers Mode a CTRL-C (see COMMAND) needs to be 
entered to return you to the Command Mode. In the Packet Transparent Mode a 
special sequence is needed (see CMDTIME). 


@® Format 


All commands are listed alphabetically. On the first line of a command will be the 
command name followed by any arguments required. Any optional arguments will 
be shown in square brackets [ ]. If the command accepts several different values, or 
a range of values, the permissible arguments will be shown in parenthesis ( ). The 
permissible arguments may also be shown separated by a vertical bar |. Timing 
parameters have their increments shown in square brackets. The second line will 
show the default value, and if it is a dual-port command. Example: 


@COMmand arguments (permissible arguments) 
default DUAL-PORT 
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Parameter Types 


@n (range) 


Any number within the range is permissible. The unit of measure (seconds, ms, baud, 
count, etc.) for the number will be described in the description. These are decimal 
numbers. 


@n ($00 - $FF) 


Several parameters are numerical codes for characters which perform special 
functions. The code is simply the ASCII character code for the desired character. 

(See the ASCII Chart at end of this manual.) Most of these characters have control 
characters as default values. Control characters are entered by holding down a special 
control key on the keyboard while typing the indicated key. For example, to type a 
CTRL-X, hold down the control key while typing an x, then release both keys. These 
special characters cannot be sent in a packet unless preceded by the pass character 
(see PASS) or unless you are operating in the Transparent Mode. 


These numbers are displayed in hexadecimal (hex) form (base 16), and as the control 
combination (CTRL-x). They can be entered either in decimal or in hex. A hex number 
is distinguished from a decimal number by preceding it with a “$” prefix. The “digits” 
of a hex number represent powers of 16, analogous to the powers of 10 represented 

by a decimal number. The numbers 10 through 15 are denoted by the hex digits A 
through F. For example: 


SB 1%16) 4 1) =. 27 


Permissible values are shown as: (n = $00 - $FF). This is true if the MODE command 
is set for 8 data bits, as defaulted. If MODE is changed to 7 data bits, then permissible 
values are $00 - $7F. See the ASCII Chart at the end of this book for character codes 
and hex/decima!l conversion. 


If a streamswitch (STREAMSW) character or any other special character is defined 
as “$” then you will need to enter values in decimal, or precede the $ with the PASS 
character in order to enter hex numbers. 


@ flags ChoiceAlChoiceB 


Many parameters are “flags”, meaning they have two possible values, ON and OFF, or 
YES and NO. All of the command descriptions show ON and OFF as the options; how- 
ever YES (y) and NO (n) may be typed instead. A few parameters are really flags, but 
rather than indicating that something is “on” or “off”, they select one of two ways of 
doing things. Some of these parameters have the values EVERY or AFTER indicating 
operating modes for data transmission. The possible choices are separated by a 
vertical bar. Some of the flag parameters will allow many choices, such as 

ON! OFF!DISCIPBBS. 


@callsigns call-n 


Several commands require callsigns as parameters. While these parameters are 
normally Amateur callsigns, they may actually be any collection of numbers and/or 
letters up to six characters; they are used to identify stations sending and receiving 
packets. A callsign may additionally include an “extension” (SSID, substation id), 
which is a decimal number from 0 to 15 used to distinguish two or more stations 

on the air with the same Amateur call (such as a base station and a repeater). The 
callsign and extension are entered and displayed as call-ext, e.g. K@OPFX-3. If the 
extension is not entered, it is set to -0, and extensions of -0 are not displayed by 

the TNC. 


er 
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@ text 


There are some commands which have a parameter text string. This string can be any 
combination of letters, numbers, punctuations, or spaces up to 256 characters. In order 
to be used, all string parameters must contain at least one non-space character. You 
can even put characters with special meanings, such as carriage return, into the string 
by preceding them with the PASS character. The string ends when you type a (non- 
passed) carriage return. Since the string parameters are dual-port parameters, a/ 
normally would not be placed in the string. If you need to have the / character in a 
string, simply type that character twice. For example, to enter a CTEXT of “Welcome 
to our station — Karl/Gloria” you would type the command: 


ctext Welcome to our station — Karl//Gloria<CR> 
@ dual port 


Entering Dual-Port Commands 


Many commands in the Data Engine are “dual-port” commands. This means that you 
enter one parameter for each of the two ports. An example of such a command would 
be BEACON. You may wish to send a beacon every 30 minutes on Port 1, and a beacon 
every 60 minutes on Port 2. 


Enter any dual port command by first typing the command name, a space, the value 
for Port 1, a slash, and then the value for Port 2. Enter a carriage return to enter the 
command. 


As an example, let’s say I want to send a beacon on port 1 every 30 minutes anda 
beacon on port 2 every 45 minutes. To enter this setting, I would type the command: 


BEACON EVERY 30/EVERY 45<CR> 


Another example would be to enter my callsign as WK5M for port 1 and WK5M-4 for 
port 2: 


MYCALL WK5M/WK5M-4<CR> 


Changing a port parameter 


When you wish to set a dual-port type parameter, but only want to change one of the 
two ports, you must specify the slash to indicate which port you wish to change. 


For example, if my txdelay is set for 30 on both of the two ports, and I wish to change 
only the txdelay for port 1, I would use the command: 


TXDELAY 5/<CR> 

In order to change only port 2, the proper command would have been: 
TXDELAY /5<CR> 

To change both ports to the same value enter: 
TXDELAY 5<CR> 
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Commands 
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@ Autolf ON!OFF 
default ON 


When ON, this command will cause a line feed ($10) to be sent to the terminal after 
every carriage return sent. If your terminal is double spacing each line, turn this 
command OFF, if it is overwriting, turn this command ON. This command will not 
affect data being sent to the radio port, only the display on your screen. 


@ AX25lvl n (n=112) 
default 2 DUAL-PORT 


This command provides compatibility with all known packet units implementing 
AX.25 protocol. When set to 2, Level 2 Version 2 protocol is implemented and the Data 
Engine will automatically adapt to whichever version the connecting station is using. 
When set to 1, Level 2 Version 1 is implemented. Set this comniand to 1 if you need to 
digipeat through other units which do not digipeat version 2 packets. You may also 
find benefit from setting this command to 1 when using several digipeaters (not nodes) 
to send packets, or when conditions are marginal between the two stations involved. 
(NOTE: Changing this setting after connecting to another station will have no effect 
on the current connection. ) 


The major difference in V1 and V2 protocol is the method used to handle retries. In 
the connected mode, if a packet is sent and not acknowledged, Version 1 will resend 
the entire packet and then disconnect if the RETRY count is reached. Version 2 will 
first send a poll, the response to this poll will determine if the packet was received. It 
is possible that the ack was collided with and therefore the packet does not need to 

be resent. If the packet was not received it will be re-transmitted. Each time a poll is 
answered the RETRY count is reset to 0. If the RETRY count is reached, Version 2 will 
attempt to re-connect unless RELINK is OFF. If the re-connect attempt is 
unsuccessful, then Version 2 will issue a disconnect. 


See also: RELINK, RETRY 


For more information the book AX.25 Amateur Packet-Radio Link-Layer Protocol 
Version 2.0 October 1984, can be obtained from the ARRL. 


@ AXDelay n (n=0- 255) [10 millisecond increments] 
default 0 DUAL-PORT 


This command will set a period of time, in addition to TXDELAY, to wait before 
sending data after keying the transmitter. This delay is required when operating 
through a standard, full duplex repeater, in order to allow the repeater sufficient time 
to turn on its transmitter. This command can also be used to allow additional delay 
when using an external amplifier on your radio. 


See also: AXHANG 
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@ AXHang n (n=0- 255) [10 millisecond increments] 
default 0 DUAL-PORT 


This command will set the expected hang time of a full duplex repeater. If data has 
been heard within this time interval, then the AXDELAY setting will be ignored, since 
the repeater transmitter is still transmitting. 


See also: AXDELAY 


@ Beacon [{EVERYIAFTER}]n (n=0- 255) [1 minute increments] 
default AFTER 0 DUAL-PORT 


A value of 0 disables the beacon. Setting a value greater than 0 activates the beacon 
under the conditions specified. If the optional keyword EVERY is used, a beacon 
packet will be sent every n*1 minute. If AFTER is used, a beacon packet will be sent 
ONCE after the specified interval with no channel activity. 


The beacon frame consists of the text specified by BTEXT, in a packet addressed and 
routed according to the setting of BPATH. 


See also: BTEXT, BPATH 


@ BPath dest [via call1, call2, ..., call8] 

default BEACON DUAL-PORT 
This commands sets the destination call (dest) and the path used to transmit beacons. 
See also: BEACON, BTEXT 


@ BReak ON|OFF 
default ON 


When ON, sending a modem break signal from your computer to the Data Engine will 
cause the Engine to return to the command mode. This will return to command mode 
from either CONVERSE or TRANSPARENT. 


See also: COMMAND 


@ Btext text (maximum 256 characters, including the command) 
default (blank) DUAL-PORT 


This command is used to specify the text to be transmitted as a beacon. Entering a 
single % will clear BTEXT. 


See also: BEACON, BPATH 


@Canline n (n=$00- $FF) 
default $18 (CTRL-X) 


This command is used to change the cancel-line input editing character. When in 
Convers or Command Mode, entering a CTRL-X will cancel all characters input from 
the keyboard back to the last un-PASSed carriage return (unless PACTIME has 
expired and CPACTIME is turned on). 


See also: CANPAC, CPACTIME, PASS 
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@® CANPac n (n=$00- $FF) 
default $19 (CTRL-Y) 


This command is used to change the cancel-packet command character. When in the 
Convers Mode, entering a CTRL-Y will cancel all keyboard input back to the last 
unpassed SENDPAC character (unless CPACTIME is turned ON and PACTIME has 
expired). 


This character also functions as a cancel-output character when in the Command 
Mode. Typing the cancel-output character a second time re-enables norma! output. 
For example, if you’ve told the Data Engine to do a DISPLAY, a CTRL-Y will cancel 
the remainder of the display, and a second CTRL-Y will re-enable the cmd: prompt 
after the next <CR>. 


See also: CANLINE, CPACTIME, SENDPAC 


@ CHeck n (n=0- 255) [10 second increments] 
default 0 DUAL-PORT 


If n is greater than 0, a periodic check (poll) will be made to determine that a 
connected state still exists when no activity has occurred for n*10 seconds. This 
prevents a “hang-up” in a connected mode when a link failure occurs as a result of 
conditions beyond control of the connected stations. If n equals 0, then this timeout 
function is disabled. If AX25LVL is set to 1, a check timeout will initiate a disconnect. 


See also: AX25LVL 


@ CMdtime n (n=0-15) [1 second increments] 
default 1 


This command sets the time allowed for entry of required characters to escape the 
Transparent Mode. In order to allow escape to Command Mode from Transparent 
Mode, while permitting any character to be sent as data, a guard time of CMDTIME 
seconds is set up. After a delay of CMDTIME since the last characters were sent to the 
Data Engine, three COMMAND characters must be entered within CMDTIME of each 
other. After a final delay of CMDTIME the Data Engine will exit Transparent Mode 
and enter Command Mode. At this time, you should see the cmd: prompt. Example (if 
CMDTIME is 1 second and COMMAND is CTRL-C): wait one second, type a CTRL-C, 
within one second type a second CTRL-C, within one second type a third CTRL-C, 
WAIT one second, cmd: prompt should appear. 


If CMDTIME is set to 0, the only exit from Transparent Mode is a modem break signal 
(if BREAK is ON). 


See also: BREAK, COMMAND, TRANS 


@CMSg ON!OFF!DISC!IPBBS 
default OFF DUAL-PORT 


When OFF, the custom connect text stored in CTEXT will not be sent to the connecting 
station upon receiving a connect request. When ON, the custom string will be sent. 
When CMSG is set to DISC, the custom text will be sent to the connecting station, and 
then the Data Engine will disconnect from that station. If set to PBBS, the custom text 
will be sent to the connecting station, and then the connection will automatically be 
transferred to your PBBS. This will occur if the PBBS is available. If the PBBS is not 
available, the Data Engine will disconnect from the station. CTEXT must contain text 
in order for the DISC and PBBS functions to operate. 


See also: CTEXT, PBBS, MYPBBS 


ce 
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@COMmand n (n= $00- $FF) 
default $03 (CTRL-C) 


This command is used to change the Command Mode entry character. When 
COMMAND is set to the default value, typing a CTRL-C causes the Data Engine 
to return to Command Mode from Packet Convers Mode. (See CMDTIME for 
returning to Command Mode from Transparent Mode.) 


See also: CMDTIME 


@ CONMode Conversational! Transparent!|NONE [Deferred| Immediate] 
default Conversational Deferred 


This command controls the mode the Data Engine will be in AUTOMATICALLY after 
a connect is received. The connect may result either from a connect request received, 
or a connect request originated by you. If the Data Engine is already in Convers or 
Transparent Mode when the connection is completed, the mode will not be changed. 
If you have typed part of a command line when the connection is completed, the mode 
change will not take place until you complete the command or cancel the line input. 
When set to NONE, no mode change will occur upon connection. 


When the optional Immediate parameter is specified, the Data Engine will switch to 
the Conmode immediately after you send your connect command, allowing you to 
immediately starting sending data intended for the other station. This is particularly 
useful when operating with satellites, since the satellite pass is usually short enough 
that you don’t want the added delay of waiting for the acknowledgement of your 
connect. When the option is set to Deferred, the Data Engine will not actually enter 
the Conmode until the acknowledgement is received, so you may continue to enter 
other commands to the Data Engine. 


See also: CANLINE, CONNECT, CONVERS, TRANS 


@ Connect dest [via calll, call2, ..., call8] 
immediate 


This command will cause the Data Engine to issue a connect request to the destination 
call (dest), using any digipeaters specified in call1 through call8. This command can 
also be used to re-establish your connection on the current stream, but using a dif- 
ferent path. Upon receipt of an acknowledgement from the distant station, the Data 
Engine will enter the mode specified in the CONMODE command. 


If CONNECT is entered with no parameters, the status of the current stream is 
displayed. 
See also: CONMODE 


@CONOk ONIOFF 
default ON DUAL-PORT 


When ON, connect requests from other TNCs will be automatically acknowledged 
and a <ua> packet will be sent. The standard connect message will be output to the 
terminal, and the Data Engine will enter the CONMODE specified. 


When OFF, connect requests from other TNCs will not be acknowledged, and a <dm> 
packet will be sent to the requesting station. The message “connect request: (call)” will 
be output to your terminal. 
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When operating with multiple connects allowed, the connection will take place on 
the next available stream. Connect requests in excess of the number allowed by the 
USERS command will receive a <dm> response, and the “connect request: (call)” 
message will be output to your terminal. 


See also: INTERFACE, CONMODE, CONNECT, MAXUSERS, USERS 


@ CONPERM ON!OFF v2.0 
default OFF 


While you are connected to a station, you can issue the CONPERM command. This 
will cause the Data Engine to maintain a connected state to that station. If the other 
station disconnects, or if a timeout occurs, or even if you turn the Data Engine off and 
then on at a later time, the Data Engine will start a connect sequence to re-establish 
the connection. The CONPERM command applies separately to each stream. The 
STATUS command will show a/P after any stream which has CONPERM set. Issuing 
the CONPERM command will show the state of CONPERM for the current I/O 
stream. 


@ CONVers 
immediate 


CONVERS has no options. It is an immediate command and will cause the Data 
Engine to enter the Conversational Mode from Command Mode on the current I/O 
stream. Any link connections are not affected. 


See also: K, COMMAND 


@ CPactime ON|IOFF 
default OFF 


When OFF and in the Convers Mode, packets are sent when the SENDPAC character 
is entered or when PACLEN is achieved. When ON and in the Convers Mode, packets 
are sent at periodic intervals determined by PACTIME. Characters are sent periodi- 
cally as in Transparent Mode, but the local editing and echoing features of Convers 
Mode are enabled. CR should normally be OFF in this configuration, otherwise the 
SENDPAC character is appended at random intervals as the input is packetized by 
the timer. 


See also: CONVERS, CR, PACLEN, PACTIME, SENDPAC, TRANS 


@CR ONIOFF 
default ON 


When ON the SENDPAC character (normally carriage return) is appended to all 
packets sent in Convers Mode. Setting CR ON and SENDPAC $0D results ina 
natural conversation mode. Each line is sent when a <CR> is entered and arrives at 
its destination with the <CR> appended to the end of the line. To avoid overprinting, 
AUTOLF may need to be ON at the receiving end. 


See also: AUTOLF, SENDPAC 
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@CStamp ON!IOFF 
default OFF 


When ON, the daytime stamp is printed with all “*** CONNECTED TO” and 
“*** DISCONNECTED” messages on the terminal. 


See also: CONNECT, DAYTIME, DAYSTRING, DISCONNECT, MSTAMP 


@ CText text (maximum 256 characters, including the command) 
default (blank) DUAL-PORT 


Enter any combination of characters and spaces up to a maximum length of 256. 
Entering a single “%” will clear CTEXT. This entry specifies the text of the automatic 
message to be sent in response to an accepted connect request provided that the 
parameter CMSG is not OFF. 


See also: CMSG 


@CWID [{Every!After}] [n] [{Tone!Key}] (n =0- 255) v1.03 
default After 0 Key DUAL-PORT 


Each increment specifies 1 minute intervals. A value of 0 turns the ID OFF. Setting a 
value greater than 0 activates the ID under the conditions specified. If the optional 
keyword Every is used, an ID will be sent every n minutes. If set to After, an ID will 
be sent ONCE after the specified interval with no channel activity. If the optional 
keyword Tone is used the callsign specified by the MYCALL command will be sent in 
CW using AFSK tones. If set to Key, the callsign will be sent by keying the PTT of the 
radio. Some countries require all stations to ID in Morse code periodically. 


See also: MYCALL 


@ DAYString dayform 
default dd/mmm/yy hh:mm:ss 


This command will set the format for display of the date and time from the Data 
Engine. The format is free-form, with any text being permitted up to a total of 31 
characters. The lower case characters m, d, y and s have special meaning to this 
command, and will be replaced with data from the software clock/calendar. The lower 
case character m will be replaced with the minutes the first time it appears after a 
lower case h. If the month is specified as a single m, months less than 10 will be 
displayed with a single digit. Likewise, if the day is specified as a single d, then days 
less than 10 will be single digit display. Entering two characters for month (mm) will 
force a two digit display for months less than 10, and two characters for day (dd) would 
force a two digit display. If the month is entered as three characters (mmm) the Data 
Engine will display the first three characters of the month name (FEB). 


Use caution when entering real text into the display, as ALL lower case m, h, d, ors 
characters WILL be translated! 


Some samples of possible strings and the resulting display would be: 


mm/dd/yy hh:mm:ss 02/26/90 11:30:00 
d.m.y h:mm:ss 26.2.90 11:30:00 
d.mm.yy h:mm 26.02.90 11:30 

mmm d 19yy h:ss CST Feb 26 1990 11:00 CST 


TIME: hh:mm DATE: mmm dd, 19yy TIME: 11:30 DATE: Feb 26, 1990 
See also: DAYTIME 
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@ DAytime yymmddhhmn\ss] 


This command will read and optionally set the software clock/calendar which displays 
the date and time in conjunction with the CSTAMP, MHEARD, and MONMODE 
TIME commands. When entering the daytime digits to set the clock, enter in pure 
number sequence with no spaces, dashes or slashes. For example: 900226113000 
would indicate 1990, February 26, at 11:30:00 hours. If DAYTIME is entered with no 
parameter, the daytime is displayed in a form depending on the DAYSTRING setting. 


See also: CSTAMP, DAYSTRING, MHEARD, MONMODE TIME 


@ DBldisc ON|OFF 
default OFF 


When OFF, only one DISCONNECT command need to be given to terminate an 
unsuccessful connect attempt. If you are currently connected, the normal disconnect 
sequence will occur. When ON, a normal disconnect sequence will always occur (you 
will not be disconnected until you receive an acknowledge of your disconnect or until 
the retry count is exceeded). A second DISCONNECT is required to force a local 
disconnect independent of the retry counter. 


See also: DISCONNECT 


@DElete n (n=$00- $FF) 
default $08 (CTRL-H) 
This command sets the character to be used as the delete character. When this 


character is typed, the last input character is deleted. The most common settings 
are $08 (backspace) and $7F (delete). 


@ DIGipeat ONIOFF 
default ON DUAL-PORT 


When ON, any packet received that has MYCALL or MYALIAS in the digipeat list of 
its address field will be re-transmitted. Each station included in the digipeat list 
relays the packet in the order specified in the address field. Digipeating takes place 
concurrently with other TNC operations and does not interfere with normal connected 
operation of the station. 


See also: HID, MYALIAS 


@® DISCMode NONE!|COMMAND 
default COMMAND 


This command controls the mode that the Data Engine will enter when a Disconnect 
is received on the current I/O stream. When set to COMMAND, the Data Engine will 
return to the Command Mode if a disconnect is received on the current I/O stream. 
When set to NONE, the Data Engine will remain in the current state when a 
disconnect is received. 


See also: CONMODE 
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@ Disconnect 
immediate 


This command will initiate an immediate disconnect request on the current I/O 
stream. A successful disconnect results in the display of *** DISCONNECTED. If the 
RETRY count is exceeded while waiting for the connected station to acknowledge, 
the Data Engine moves to the disconnected state on that stream. Entering a second 
DISCONNECT command before RETRY has expired will result in an immediate 
disconnect on your end, however, the other station may be left thinking it is still 
connected to you. Disconnect messages are not displayed when the Data Engine 

is in the Transparent Mode. Other commands may be entered while the disconnect is 
in progress. 


Disconnect MYPBBS 


Issue this command if you want to cause the personal mailbox to issue a disconnect 
to the user of the mailbox. D MYPBBS is what you should type, do not type the call 
entered in the mypbbs command. 


Disconnect MYNODE x (x = KA-Node circuit) v2.0 


x may be any of the KA-Node circuits in use, designated by A, B, C, etc. This command 
will cause the node to disconnect the stations linked through the node on the circuit 
specified. MYNODE does not refer to the call entered in the mynode command, but is 
the actual characters to type. 


See also: DBLDISC, DISCMODE, RETRY, STATUS 


@ DISPlay {[c] 


This command causes the Data Engine to display a list of all of the parameters. 
You may also display only selected parameters by specifying the appropriate class 
identifier for that group. When using the DISPLAY command with a class, be sure 
to use a space between the DISPLAY command and the class. Classes of related 
parameters are: 


(A)syne asynchronous port parameters (TNC to computer) 
(C)haracter special Data Engine characters 

(I)d identification parameters 

(Lyink parameters affecting packet link (TNC to TNC) 
(M )onitor parameters affecting packets to be monitored 
(P)bbs mailbox parameters 

(Timing parameters affecting timing 


Individual parameter values can be displayed by entering the command name followed 
by <CR>. 


@ DWait n (n=0- 255) [10 millisecond increments] 
default 0 DUAL-PORT 


This value is used to avoid collisions with digipeated packets. The Data Engine 

will wait n*10 milliseconds after last hearing data on the channel before it begins 
its own key-up sequence. The best value will be determined by experimentation, 
but will be a function of the key-up time (TXDELAY). This feature is made available 
to help alleviate the drastic reduction of throughput which occurs on a channel 
when digipeated packets suffer collisions. Digipeated packets are not retried by the 
digipeater, but must be restarted by the originating station. If all stations specify 
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DWAIT, and the right value is chosen, the digipeater will capture the frequency every 
time it has data to send, since digipeated packets are sent without this delay. 


Observations have proven that a better algorithm for avoiding collisions between end- 
user stations, while still allowing digipeaters the high-priority access they require, is 
achieved using persistence and slottime to determine proper transmit intervals. 


See also: PERSIST, SLOTTIME 


@ Echo ON!OFF 
default ON 


When ON, characters received from the computer by the Data Engine are echoed 
back to the terminal. If you are receiving double print of characters you type on the 
keyboard, turn this command OFF. This corresponds to the setting in your terminal 
program for DUPLEX. If your program is set for full-duplex, set ECHO ON. If your 
program is set for half-duplex (some call it echo) then set ECHO in the Data Engine 
OFF. Regardless of the setting of this command, the Data Engine will not echo an 
X-OFF or X-ON character to the terminal when it receives a STOP or START 
character. Echo is disabled in Transparent Mode. 


@ Flow ONIOFF 
default ON 


When FLOW is ON, any character entered from the terminal will halt output to the 
terminal until the current packet or command is completed (by SENDPAC, PACLEN, 
or PACTIME). Cancelling the current input to the Data Engine or typing the 
REDISPLAY-line character will also cause the output to resume. FLOW will keep 
received data from interfering with data entry. When FLOW is OFF, received data 
will be “inter-leaved” with keyboard entry. If using a split-screen terminal program, 
you should have FLOW OFF and ECHO OFF to allow received data to be displayed 
while you type into the Data Engine’s type-ahead buffer. 


See also: CANLINE, CANPAC, CPACTIME, ECHO, PACLEN, REDISPLAY, 
SENDPAC 


@FLOWR ONIOFF 
default ON 


When ON the Data Engine will stop sending characters to the attached terminal when 
it receives a STOP character, and will resume sending when a START character is 
received. This command is effective only in the Convers and Command modes, and 
must be ON to enable software flow control between the computer and Data Engine. 


See also: FLOWTR, FLOWTX, FLOWX, START, STOP 


@FLOWTr ON!IOFF 
default OFF 


When ON the Data Engine will stop sending characters to the attached terminal 
when it receives a STOP character, and will resume sending when a START character 
is received. This command is effective only in the Transparent mode, and must be ON 
to enable software flow control between the computer and Data Engine. 


See also: FLOWR, FLOWTX, FLOWX, START, STOP 
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@ FLOWTX ON! OFF 
default OFF 


When ON, the Data Engine will send an XOFF character to the attached terminal 
when it can not accept any more data from the terminal. When the Data Engine is 
again able to receive characters from the terminal, it will send an XON character. 
This command is effective only in the Transparent mode, and must be ON to enable 
software flow control between the computer and Data Engine. 


See also: FLOWTR, FLOWX, FLOWR, XON, XOFF 


@ FLOWX ON!OFF 
default ON 


When ON, the Data Engine will send an XOFF character to the attached terminal 
when it can not accept any more data from the terminal. When the Data Engine is 
again able to receive characters from the terminal, it will send an XON character. This 
command is effective only in the Convers and Command modes, and must be ON to 
enable software flow control between the computer and Data Engine. 


See also: FLOWTR, FLOWTX, FLOWR, XON, XOFF 


@ FRack n (n=1-15) [1 second increments] 
default DUAL-PORT 


After transmitting a packet requiring acknowledgement, the Data Engine waits 
FRACK seconds before incrementing the retry counter and sending the packet again. 
If the retry count (specified by the RETRY command) is exceeded, the current 
operation is aborted. If the packet address includes relay requests (digipeaters), the 
time between retries is adjusted to FRACK * ((2 * m) + 1) where m is the number of 
intermediate relay stations specified. When the retried packet is sent, a random wait 
time is also added to avoid lockups where two units repeatedly collide with each other. 
The FRACK timer begins when PTT is released and is suspended when data carrier 
from the radio is present. 


See also: RESPTIME, RETRY 


@® FREeram 
immediate 


This command will cause the Data Engine to display the number of bytes of RAM 
memory that are currently not assigned. 


@® Help [command] 


This command, when entered without any arguments, will display a list of all of the 
commands available in the Data Engine. If an optional command is given, a brief 
description of the stated command is displayed. 


@HId ON!IOFF 
default ON DUAL-PORT 


When ON, an ID packet will be sent every 9.5 minutes, provided that packets are 
being digipeated through your station, or routed into your PBBS. This command 
should be ON if digipeating, gateway, or PBBS is enabled. If OFF, periodic 
identification packets will not be sent. 
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The ID packets will be addressed to the destination specified in the IPATH command, 
and will follow the path indicated in the IPATH command. The text of the ID message 
is specified using the ITEXT command. 


See also: DIGIPEAT, IPATH, ITEXT, PBBS 


@lId 
immediate 


When this command is entered, an identification packet will be forced. This command 
can be used to insure that your station identification is the last transmission before 
taking the station off the air. The ID packet is an un-numbered information <UI> 
frame whose data consists of your ITEXT. This packet will be addressed to the 
destination call specified in IPATH, and digipeated by any via addresses contained 

in the IPATH. 


See also: IPATH, ITEXT 


@ INterface TERMINALIBBS!HOST!IKISS 
default TERMINAL 


This command will select the type of data communication between the Data Engine 
and the attached terminal. When set to TERMINAL, the Data Engine will operate 
with a standard telecommunications terminal program, or even a “dumb terminal”. 
When set to BBS, the Data Engine will prevent specific messages from being sent to 
the attached terminal. This will allow full service BBS system, such as WORLI, 
WA7MBL, and others, to operate without extraneous messages being generated by 
the Data Engine. When set to HOST, the Data Engine will package all data in a Host 
Mode format, and expects the attached terminal to package its data in the same 
format. (See the Host Mode Operation section for details on the Data Engine Host 
Mode.) When set to KISS, the KISS protocol as defined by Phil Karn (KA9Q) is 
implemented between the Data Engine and the attached terminal. 


@ Path dest [via call1, call2, ..., call8] 
default ID DUAL-PORT 


This command sets the destination call (dest) and the path used to transmit ID 
packets. 


See also: ID, ITEXT 


@IText text (maximum 256 characters, including the command) 
default (blank) DUAL-PORT 


This command is used to set the text that is transmitted in the data portion of every 
ID packet. Entering a single % will clear ITEXT. 


See also: HID, ID, IPATH 


@K 

immediate 

This single letter command is synonymous with CONVERS. It is included as a single- 
keystroke convenience for entering Convers Mode. 


See also: CONVERS 
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@ KIssaddr n (n=0- 15) v1.04 
default 0/1 DUAL-PORT 


This command allows you to set the address used to send KISS data to the two radio 
ports of the Data Engine. The address is sent by the KISS software in the upper nibble 
of the command byte. The value used must be different for each port. 


See also: KISS section of the manual 


@ KNtimer n (n=0- 255) v2.0 
default 15 


If there is no activity (data) on a KA-Node circuit for n minutes, the KA-Node will 
disconnect both the input and output sides of the KA-Node circuit. Setting KNTIMER 
to 0 disables this feature. 


@ KNxXcon ON!|OFF 
default OFF 


When OFF, the KA-Node will not allow the Xconnect command (cross connecting). 
When ON, the Xconnect command is enabled, allowing users to connect from one port 
of the KA-Node to the other. 


See also: NUMNODES, MYNODE 


@Leds ON 
default ON 


When OFF the software controlled front panel LEDS will not light, in order to 
conserve power. 


@LFadd ON|IOFF 
default OFF 


When ON, a linefeed character <LF> is added to outgoing packets following each 
carriage return <CR> transmitted in the packet. This function is similar to AUTOLF, 
except that the linefeed characters are added to outgoing packets rather than to text 
displayed locally. This feature will permit you to add linefeeds to outgoing packets if 
the station you are linked to is receiving overprinted packets on his display and has no 
local means to correct it. This character insertion is disabled in Transparent Mode. 


See also: AUTOLF 


@ Lidlist NONE! call[,call, ..., call] | {+!-}call (1 - 10 calls) 
default NONE DUAL-PORT 


Any stations listed in the LIDLIST will be completely ignored by the Data Engine. 
Stations may be added to the list by specifying a + before the call, or deleted from the 
list by specifying a — before the call. 
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@ MAxframe n (n=1-7) 
default 4 DUAL-PORT 


MAXFRAME sets an upper limit on the number of unacknowledged packets which can 
be outstanding at any one time. The Data Engine will send MAXFRAME number of 
packets in a single transmission, if they are available. 


See also: PACLEN 


@ MAXUsers n (n=1- 26) 
default 10 DUAL-PORT 


This command causes the Data Engine to allocate the memory required for the 
maximum number of simultaneous connections you wish to allow. Each connection 
uses a different stream. In order to direct what you want to say to a different stream, 
you use the STREAMSW character, followed by the stream ID. All streams may be 
used for outgoing packets, but USERS sets the number that may be used for incoming 
connections. Changing the value of MAXUSERS will cause the Data Engine to perform 
a “soft reset”. In order to change the current value of maxusers, you must not be 
connected to any station on any stream. 


See also: STATUS, STREAMSW, USERS 


@ MHeard n!lLONG!ISHORT (n=0- 15) 
default 10 


If the optional parameter n is specified, the Data Engine will maintain a log of the 
last n stations heard. Entering the MHEARD command without any options results 
in a standard display of the stations in the MHEARD list which includes the date and 
time the station was last heard. Entering the MHEARD LONG command will cause 
the listing to include the digipeaters being used by the stations and the destination 
callsigns contained in the last transmission monitored for each station. If the 
MHEARD SHORT command is given, only the callsigns of the last n stations will 

be displayed. MHEARD logging will be disabled if PASSALL is on. 


See also: MONMODE TIME, PASSALL 


@MOde [bl[,[p],{dJ,{s]] 
(b = 01300 - 38400) 
(p = NONE! EVEN !|ODD|1MARKISPACE) 
(d= 718) 
(s = 112) 
default 0,N,8,1 


The MODE command is used to set the serial port parameters of the Data Engine for 
communication with the attached terminal. The b parameter sets the terminal baud 
rate, p sets the parity, d is the number of data bits, and s is the number of stop bits. 
Entering only a baud rate (b) will change the baud rate, leaving the other parameters 
unchanged. When b is set to 0, the Data Engine will perform an autobaud routine 
when powered up. To change the parity without any other changes, you must either 
enter the baud rate and the parity or enter the comma before the parity. For example, 
to change only the number of data bits, you could enter the command: 


MODE ,,7 
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@ MODEM ai{,{d],[b]] 


(a= 01112) 
(d = FULL! HALF) 
(b = 1 - 65535) 
default 0, HALF,1200 DUAL-PORT 


This command is used to configure the Data Engine to operate properly with various 
modems. When MODEM is entered without any parameters, the type of modem will 
be shown, along with the user selected parameters — a, d, b. The TYPE is automati- 
cally selected when using a Kantronics modem (such as the DE1200 modem). In order 
to use other modems, refer to the appendix on “Connecting Other Modems to the Data 
Engine”. 

The a parameter is an auxiliary setting, and will vary with the type of modem 
installed. For the Kantronics 1200 baud internal modem, the values indicate the 

type of carrier detect used as follows: 


0 = Sine wave carrier detect on modem board. 
1 = 3105 carrier detect (energy). 
2 = External carrier detect circuit. 


The b parameter specifies the baud rate used by the modem. Valid selections will 
depend on the modem installed. 


The d parameter sets the duplex mode of the modem; FULL! HALF. 


@ Monitor ON|OFF 
default ON DUAL-PORT 


As used with the Data Engine, the term “monitor” means to display information on 
your terminal which is not addressed to your station. 


When OFF you will display only those stations connected to you, no matter how other 
monitor commands are set. When ON, packets will be monitored based on the settings 
of the MONLIST, MONMODE, and MONTYPE commands. Any station listed in the 
LIDLIST will not be monitored under any circumstances. The addresses in the packets 
are displayed along with the data portion of the packet. Callsigns (to and from fields) 
are separated by a “>” and the callsign extension field (SSID) is displayed ifit is other 
than 0. All monitor functions are disabled in Transparent Mode. 


See also: LIDLIST, MONLIST, MONMODE, MONTYPE 


@MONList (1- 10calls) 

NONE! ALL! moncalls | ALL [EXCEPT] moncalls | {+ !—}call{(TO) | (FROM)] 
default ALL DUAL-PORT 
In this command, “moncalls” has the general form: 

callsign[{(TO) | (FROM)] 


The MONLIST command will allow you to determine the source and destination 
callsigns to be monitored by the Data Engine. When set to ALL, all packets will be 
displayed on the local terminal, if permitted by the other monitor commands. When 
set to NONE, the Data Engine will not monitor any packets, regardless of the source 
or destination fields. If you are connected to another station, any packets received 
from that station addressed to you will be output to the terminal regardless of the 
setting of MONLIST. 
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Some examples of setting the MONLIST using moncalls will follow to help you 
understand proper entry format. 


To set a specific list of stations to be monitored, you might use the command: 
MONLIST WK5M,W®@XI(TO),WD@EMR(TO),KOVAY(FROM) 


A station may be added into the allowed monitoring list by using the command 
MONLIST +call. Optionally you may specify (FROM) or (TO) immediately after the 
callsign to monitor only those packets FROM or TO the designated callsign. 


You may also remove a station from being monitored with the command MONLIST 
—call. 


In order to only monitor a specific list of stations, you can use the MONLIST command 
and specify the specific stations you wish to monitor. Suppose I wish to monitor only 
W®XI, WD@EMR, and WK5M. I could accomplish this with the command: 


MONLIST WOXI,WDGEMR,WK5M 


In addition to the above, I may want to monitor all packets addressed to MAIL, 
regardless of the source of those packets. This can be accomplished by the command: 


MONLIST +MAIL(TO) 


Another example might be that I wish to monitor all packets except for the local 
Bulletin Boards. The calls of the Bulletin Boards I do not want to monitor are 
WB@AEX, WOXK, and K@VAY. The command used to do this would be: 


MONLIST ALL EXCEPT WB@AEX,WOXK,KOVAY 


As a final example, let’s say that I want to monitor any packets from WO@XI, and any 
packets addressed to MAIL, and any packets going to or coming from WK5M. The 
following command will accomplish this: 


MONLIST WK5M,W@XI(FROM),MAIL{TO) 


I could also have accomplished the same end result with the following three 
commands, entered at different times: 


MONLIST WK5M 

MONLIST +W@XI(FROM) 

MONLIST +MAIL(TO) 
See also: MONITOR 


@ MONMode NONE! ALL! mode! {+1!—}mode 
default NONE DUAL-PORT 
In this command, “mode” can be any of the following: 

CONNECTED, FILTER, HEADER, PATH, TIME. 


This command is used to determine what information will be monitored. If you are 
connected to another station, any packets received from that station addressed to you 
will be output to the terminal regardless of the setting of MONMODE. 


If set to NONE, the Data Engine will only monitor packets when you are not currently 
connected to another station, and will display only the source callsign, destination 
callsign, and any information contained in the data field of the frame. 


The modes available, and their function, are as follows: 
CONNECTED Monitor packets when connected to another station 
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FILTER Strip all control characters from monitored packets except 
for <CR> and <LF> characters 


HEADER The Data Engine will output a newline sequence to the 
terminal after the address information and before the data 
portion of a frame received. 


PATH The Data Engine will display the complete path information 
contained in the address field. The source address would 
appear first, followed by the “>” character and then the 
destination address. If any digipeaters are contained in the 
address field, the Data Engine will display the word “via” 
followed by a comma-separated list of the digipeaters used. 
An asterisk (*) will indicate the station that actually trans- 
mitted the displayed packet. 


TIME The Data Engine will display a time stamp on the monitored 
packets. 


See also: DAYTIME, MONITOR, STREAMCA, STREAMEV 


@ MONType NONE!ALLItypes |! {+1-}type 
default DATA,UNPROTOS DUAL-PORT 
Valid types for this command are: 

COMMANDS, CONNECTS, DATA, PIDS, RESPONSES, UNPROTOS, XMIT 


This command determines the types of packets which will be monitored. The default 
value — DATA, UNPROTOS - will cause the Data Engine to monitor any I-frame 
between two connected stations, as well as any Un-numbered I-frame. I-frames are 
those frames which actually contain data a user has transmitted to another station. 
An Un-numbered I-frame results from a user sending data while that user is not 
connected to another station. 


If COMMANDS is specified, the Data Engine will display the supervisory frames sent 
between two connected TNCs, which are used to check the validity of a link, or to 
query the other station concerning whether a previously sent packet was successfully 
received. 


If CONNECTS is specified, the Data Engine will send CONNECTS <C>, 
DISCONNECTS <D>, DISCONNECTED MODE <dm>, and UN-NUMBERED 
ACKNOWLEDGEMENTS <ua> to the attached terminal for monitoring. 


Specifying DATA will cause the Data Engine to monitor information containing frames 
between other connected users. (Data being sent in a connected state to your station is 
not considered monitored data, and will always be sent to your terminal.) 


If PIDS is specified, the Data Engine will send information to your terminal which is 
contained in any received frame, regardless of the Protocol ID (PID) in use. When not 
specified, you will only monitor information which has a PID of $F0. This is pure 
AX.25, end user information. Some examples of other PIDS in use that you probably 
would not want to monitor are: 


SG Gray The PIP 
SCUMmeLUr IE 
$CF Net/Rom, TheNet, or GGBPQ Packet Switch 


If RESPONSES is specified, the Data Engine will display the supervisory frames sent 
between two connected TNCs which are used to acknowledge information frames or 
other COMMAND frames. 
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If UNPROTOS is specified, the Data Engine will send Un-numbered I-frames 
(Unproto data <UI>) to the terminal for monitoring. 


If XMIT is specified, the Data Engine will send the transmitted frames to the terminal 
for monitoring. 


See also: MONITOR 


@ MYAlias call[-n}| NONE 
default NONE DUAL-PORT 


This command is used to enter an alias into the Data Engine which may be used for 
digipeating. Setting MYALIAS NONE will eliminate the MYALIAS callsign and also 
disables the ability for a station to digipeat through you using an alias. 


See also: MYCALL, MYGATE, MYPBBS, MYREMOTE 


@ MYcall call[-n) DUAL-PORT 
This command is used to enter your callsign into the Data Engine. 


When the Data Engine is first turned on out of the box, or after a hard reset, it asks 
you for your callsign — there is NO DEFAULT. The callsign you enter is placed in this 
parameter. The extension n is called a Substation ID (SSID) and is defaulted as 0, 

but may be any number from 0 to 15. All packets originated by the Data Engine will 
contain this callsign in the FROM address field. Any packets received by the Data 
Engine with this callsign in the TO address field or digipeat fields will be responded to 
appropriately (connect, disconnect, ack, digipeat, etc). 


See also: MYALIAS, MYGATE, MYPBBS, MYREMOTE 


@ MYGate call[-n]| NONE 
default MYCALL-3 


This command is used to enter a callsign or alias into the Data Engine which may be 
used as a gateway between the two radio ports. Setting MYGATE NONE will remove 
the MYGATE callsign which also disables the ability for a user to cross-port digipeat 
through your station. This does not affect the KA-Node cross connect capability. 


See also: KNXCON, MYCALL, MYALIAS, MYPBBS, MYREMOTE 


@MYNode call[-n]| NONE v2.0 
default MYCALL-7 DUAL-PORT 


Setting this command to a callsign or character string enables the KA-Node in the 
TNC. You must also have the NUMNODES command set to a non-zero value. You 
may disable the KA-Node by setting MYNODE to NONE, or setting NUMNODES 0. 


See also: DIGIPEAT, NDWILD, NUMNODES 


@MYPbbs call{-n]| NONE 
default MYCALL-1 DUAL-PORT 


This command is used to enter a callsign or alias into the Data Engine which may 
be used to access the Personal Mailbox. 


See also: MYCALL, MYALIAS, MYGATE, MYREMOTE, PBBS 
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@® MYRemote call[-n]| NONE 
default NONE DUAL-PORT 


This command is used to enter a callsign into the Data Engine which may be used to 
access the commands of the Data Engine remotely. Once entered a soft reset must be 
given to activate the desired change. 


This will allow you to change the configuration of the Data Engine. Use CAUTION 
when accessing the remote, as it is possible to change parameters to the point that 

the Data Engine will no longer communicate. If this occurs, you will have to connect 

a terminal to the unit locally. Also, be aware that some commands may cause the 

Data Engine to perform a soft reset — for instance, changing the size of the PBBS. This 
would cause ALL connected streams to be disconnected. Since access to the command 
set of the Data Engine will allow ALL parameters to be changed, a password scheme 
(see RTEXT) is used to verify that the user attempting to connect to the remote is 
properly authorized. 


See also: MYCALL, MYALIAS, MYGATE, MYPBBS, RESET, REMTIMER, RTEXT 


@NDWild ON|OFF v2.0 
default OFF 


When OFF, the KA-Node will only recognize connect requests directed to the 
MYNODE call. When ON, connect requests to any SSID of the MYNODE call will be 
recognized as connects to the KA-Node, if that SSID is not being used for any other ID 
in the TNC. 


See also: MYALIAS, MYCALL, MYGATE, MYNODE, MYPBBS, MYREMOTE 


@ NHeard [nIS!IL] (n=0- 15) v2.0 
immediate 


Setting NHEARD with the optional n value will enable the Data Engine to keep a log 
of the last n number of nodes heard. Once enabled with a value of n greater than 0, 
you may display this log by using the NHEARD command with no argument, or with 
the optional LONG or SHORT argument. This command allows the operator to display 
a list of nodes whose ID packets have been heard by the TNC. The lists includes 
KA-Nodes as well as TheNet, Net/Rom and G8BPQ nodes. TheNet, Net/Rom and 
G8BPQ nodes are identified as: 


ALIAS (CALLSIGN) 
and Kantronics KA-Nodes will be identified as: 
MYNODE (MYCALL) 


An asterisk, *, indicates that the station was heard through a digipeater. The 
date/time the station was last heard is also displayed. If the S option is used, i.e. 
NDHEARD §, then only the callsigns of the stations heard will be displayed. If 

the L option is selected, all callsigns contained in the received packet are displayed. 


See also: MYNODE 
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@ NText text (maximum 256 characters, including the command) v2.0 
default (blank) 


This entry specifies customized text to be sent with the initial KA-Node sign-on 
message (when the KA-Node is connected to by a remote station). Enter any 
combination of characters and spaces up to a maximum length of 253. Entering a 
single “%” will clear NTEXT. 


See also: MYNODE, NUMNODES 


@ NUMNODES n (n=0- 26, maximum may be limited by available RAM) v2.0 
default 0 


This command is used to set the number of allowable circuits through the KA-Node. 
For example, if you wish to allow up to 6 simultaneous circuits through the node, set 
NUMNODES 6. The number allowed will depend upon the amount of RAM available 
in your TNC. If you select n larger than the available RAM will allow, an “out of range” 
message will be returned to you. Generally, set the amount of RAM required first for 
your PBBS (personal bulletin board) and then set the desired number of circuits. This 
command will cause a soft reset. 


See also: MYNODE 


@Onecd ON|IOFF v2.0 
default OFF 


When ON, the Data Engine will not transmit on either port whenever it detects 

a signal present on either port. This allows both ports of the Data Engine to be 
connected to a single radio for dual speed operation on the same frequency. Note 
that you will also need to connect the RTS pin from port one to the CTS pin on port 
two, and RTS from port two to CTS on port one in order to prevent both modems 
from trying to transmit at the same time. 


@Paclen n (n=1- 256) 
default 128 DUAL-PORT 


This command specifies the maximum length of the data portion of a packet. The Data 
Engine will automatically send a packet when the number of input bytes reaches n. 
This value is used in both the Convers and Transparent Modes. 


See also: MAXFRAME 


@ PACTime [EVERY!AFTER]n (n=0- 255) [1 second increments] 
default AFTER 1 


This parameter is always used in Transparent Mode, and will also be used in Convers 
Mode if CPACTIME is ON. When AFTER is specified, bytes are packaged when input 
from the terminal stops for n seconds. When EVERY is specified, input bytes are 
packaged and queued for transmission every n seconds. A zero length packet is never 
produced, and the timer is not started until a new byte is entered. If EVERY or 
AFTER is not given, the current state is retained. 


See also: CPACTIME, TRANS 
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@ PASs n (n= $00- $FF) 
default $16 (CTRL-V) 


This command selects the ASCII character used for the “pass input” editing command. 
You may use this character to send any character in a packet while in Convers Mode, 
even though that character may have a special function. For example, if you wish to 
send a dollar sign ($) in a packet, but your STREAMSW is set to $24 ($), you can do so 
by preceding it with the PASS character. The character will be sent rather than being 
interpreted as a STREAMSW by the Data Engine. 


In Transparent Mode, all characters are passed, there are no special functions except 
the one combination to get out of Transparent Mode. 


@ PASSA ONIOFF 
default OFF DUAL-PORT 


When OFF, packets will only be displayed if the CRC (error checking) is correct, and 
according to monitor commands. When this command is ON, the Data Engine will 
display packets, regardless of whether or not the CRC is correct. The Data Engine will 
attempt to decode the address field as well as the data field and display the packets as 
specified by other commands such as MONTYPE. The entire packet, determined by 
the beginning and ending flags, must be received before an attempt is made to decode. 
If both flags are not received, the data will not be decoded. MHEARD logging is 
disabled when PASSALL is ON. 


See also: MONTYPE, MHEARD 


@PBbs n (maximum depends on RAM) 
default 5 


Setting n greater than 0 allocates memory and activates the Personal Mailbox in the 
Data Engine. The amount of memory allocated will be n Kilobytes, and may be limited 
by the MAXUSERS command. Changing the size of the PBBS memory allocation will 
not affect the contents of the mailbox (messages will be preserved) so long as sufficient 
memory remains allocated to store the existing messages. Using the PBBS n command 
with n greater than 0 will ALWAYS renumber the messages in the mailbox beginning 
with message number 1. This command causes a soft reset if n is different from its 
previous value. 


See also: CMSG, FREERAM, MYPBBS, MAXUSERS, PBTIMER, PBPERSONAL, 
PTEXT 


@ PBForward _ bbscall [VIA call1,call2,...call8] [PORT 112] [EVERY ! AFTER n] 
default NONE EVERY 0 v2.0 


This command causes your PBBS to attempt to initiate a forward of any eligible mail 
to another BBS system periodically. Any message in your PBBS which contains an 
@BBS field and is not being HELD (H) or has not previously been FORWARDED (F) 

is eligible to forward. If the keyword EVERY is used, the PBBS will attempt to forward 
once every n hours. If you specify the keyword AFTER, the PBBS will attempt to 
forward whenever a user disconnects from the PBBS, and every n hours after that. 
Setting the time interval will cause the PBBS to attempt to forward immediately, if 
there is anything to forward. 
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@ PBHeader ON|OFF v2.0 
default ON 


When ON, the routing headers received from a full service BBS will be stored in the 
PBBS mailbox. When OFF, these headers are not stored in the mailbox, allowing 
messages to require considerably less space. The routing headers are those lines you 
normally see in messages beginning with R:. Note that the PBBS will ignore all lines 
beginning with R: until it sees the first line that does not have R: in column one. From 
that point on, all of the message will be stored, even if a line begins with an R:. 


See also: PBBS section of the manual 


@PBHOld ON!IOFF v2.0 
default ON 


When ON, any message received over the radio will automatically be held by your 
PBBS for you to review. You may then release the message for forwarding by editing it 
and changing the H flag (for example, to edit message number 4: E 4 H). When OFF, 
messages received over the radio are not held, but may immediately be forwarded from 
your PBBS. (Note that any message addressed TO or @ your MYCALL or MYPBBS 
call will be held regardless of the setting of PBHOLD.) 


@ PBKillfwd ONIOFF v2.0 
default ON 


When ON, private and traffic messages will be killed (deleted) from your PBBS 
automatically after they have been forwarded to another BBS. When OFF, these 
messages will not be killed, but will be marked with the forwarded (F) flag to 
prevent them from forwarding again. 


@PBLo [Old!New] [Fixed! Variable] v2.0 
default NEW VARIABLE 


When set to OLD, the PBBS will list messages to the user from the oldest to newest 
(i.e. ascending numerical order). When set to NEW, the newest message will be listed 
first. When the second parameter is set to FIXED, the user cannot change the listing 
order. When the second parameter is set to VARIABLE, the user may change the order 
in which messages will be listed by using the LO command within the PBBS. 


See also: Pbbs section of the manual 


@ PBPersonal ON|OFF 
default OFF 


When OFF, the personal mailbox will allow messages to be sent to any callsign. When 
ON, only messages addressed to the MYCALL or MYPBBS callsigns will be accepted. 
Messages entered from the keyboard may be addressed to anyone regardless of the 
setting of this command. 


See also: MYCALL, MYPBBS, PBBS 
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@ PBTimer n (n=0-10) [1 minute increments] 
default 10 


The PBTIMER will set the amount of time the PBBS will remain connected to a user 
if no data is being received. After n minutes of no activity, the PBBS will automatically * 
disconnect from the user. Setting PBTIMER to 0 disables this function. 


See also: PBBS 


@ PERSist n (n=0- 255) 
default 64 DUAL-PORT 


n is used to determine if a packet will be sent after SLOTTIME expires. For example, 
let’s assume a PERSIST setting of 63 and a SLOTTIME setting of 10. This slottime 
setting corresponds to 100 milliseconds. When the Data Engine detects that the 
channel is clear and available (no carrier is detected), it starts a timer (SLOTTIME). 
When the timer expires (100 milliseconds in our case) the Data Engine generates a 
random number between 0 and 255. If the generated number is equal to or less than 
the PERSIST value, the Data Engine keys up the transmitter and sends the data 
packet. With our setting of 63, the odds of this occurring after the first slottime are 1 
in 4. (Actually the probability is PERSIST plus 1 divided by 256.) If the Data Engine 
generated random number is greater than PERSIST, the Data Engine re-starts the 
timer and waits for the timer to expire again before generating a new random number. 
This is repeated until the Data Engine gains channel access and sends its packet of 
information. 


The algorithm used to determine whether or not to transmit using the PERSIST/ 

SLOTTIME method has been shown to be considerably more sophisticated than the 

DWAIT method used by most standard AX.25 packet stations. The result of using the 

persistence algorithm is increased throughput under most channel conditions. Making 
SLOTTIME smaller will cause the Data Engine to generate random numbers more a 
frequently, whereas raising the PERSIST value will give a better chance (improve the 
odds) of transmitting the data. Through careful choice of these values, it is possible 

to improve data throughput while at the same time permit shared channel usage by 
other packet stations. The persistence algorithm has been added on top of the DWAIT 
algorithm. 


See also: SLOTTIME 


@ PHEARD [n] (n=0- 100) v2.0 
default 0 


Setting PHEARD with the optional n value will enable the Data Engine to keep a log 
of the last n number of stations connecting to the PBBS. Once enabled with a value of 
n greater than 0, you may display this log by issuing the PHEARD command with no 
arguments. 


@POrt n (n=01112) 
default 0 


If n is 0, the Data Engine will operate only through radio port 1. Radio port 2 will be 
disabled in this configuration. Setting n to 1 will enable both radio ports, and when 
first turned on, the current I/O stream will be on port 1. Ifn is set to 2, both ports are 
again enabled, but the active I/O port when the unit is turned on will be port 2. 
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@ PText text (maximum 256 characters, including the command) 
default (blank) DUAL-PORT 


This entry specifies the customized text sent with the initial PBBS (Personal Mailbox) 
sign-on message (when a remote station connects to the PBBS). Enter any combi- 
nation of characters and spaces up to a maximum length of 256 characters. Entering 
a single “%” will clear PTEXT. If you plan to “reverse forward” to a full-service BBS, 
do not place a > character anywhere in the PTEXT. 


See also: PBBS 


@ Redisp n (n= $00- $FF) 
default $12 (CTRL-R) 


This command is used to change the REDISPLAY-packet input editing character. 
The parameter n is the ASCII code for the character you want to type in order to 
REDISPLAY the packet currently being entered. 


You can type this character to cause the Data Engine to re-display the packet you 
have begun. When you type the REDISPLAY-packet character, the following things 
happen: First, type-in flow control is released (if FLOW was enabled). This displays 
any incoming packets that are pending. Then a \ (backslash) character is displayed, 
and the packet you have begun is redisplayed on the next line. If you have deleted 
and retyped any characters, only the final form of the packet will be shown. You are 
now ready to continue typing where you left off. Incoming packets will continue to be 
displayed until you type the next character to be inserted into the packet. 


You can use this character if you are typing a message in Convers Mode and a packet 
comes in. You can see the incoming message before you send your packet, without 
cancelling your input. 


See also: CANLINE, CANPAC, FLOW 


@® RELink ON!OFF 
default OFF DUAL-PORT 


When ON, the Data Engine operating with AX25LVL 2 will attempt to automatically 
reconnect after RETRY is exceeded. When OFF, the Data Engine operating with 
AX25LVL 2 does not attempt to automatically reconnect. The PBBS will never attempt 
to reconnect regardless of the setting of this command. If using AX.25 Level 2 Version 
1 (AX25LVL 1) this command has no effect. 


See also: AX25LVL, RETRY 


@ REMtimer n (n=0-10) [1 minute increments] 
default 2 


This command sets the amount of time a station may stay connected to the 
MYREMOTE without sending any data. After n minutes, the Data Engine will force 
a disconnect from the MYREMOTE if no data has been received from the connected 
station. 


In addition, if the proper password is not entered within three (3) attempts, the 
MYREMOTE will disconnect the current user and will not accept any connects for 
15 minutes. 


See also: MYREMOTE, RTEXT 
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@ RESEt 
immediate 


This command is used to perform a soft reset. The contents of the mailbox are 
preserved, and the MHEARD log is not cleared. Any existing connections will no 
longer be recognized by the Data Engine, even though the other end still believes 
it is connected to you. The initial sign-on message will be displayed. 


See also: MAXUSERS, MYREMOTE, PBBS, RTEXT 


@ RESptime n (n=0- 255) [100 millisecond increments] 
default 5 DUAL-PORT 


The number specified establishes a minimum delay, in 100 millisecond increments, 
that is imposed on acknowledgement of information-bearing packets (I-frames). Delay 
may run concurrently with DWAIT (PERSIST and SLOTTIME) and any other random 
delays in effect. This command is useful in avoiding collisions during such activity as 
file transfers using full-length packets. 


See also: FRACK 


@ RESTORE DEFAULTS 
immediate 


This command will completely restore your Data Engine to factory defaults. The 
Data Engine will return all parameters to factory values, and will run the autobaud 
routine, asking you to PRESS (*) TO SET BAUD RATE. Any messages in the mailbox 
will be deleted. 


See also: RESET 


@RETry n (n=0- 15) 
default 10 DUAL-PORT 


This command specifies the number of packet retries. Packets are re-transmitted n 
times before the operation is aborted. The time between retries is specified by the 
command FRACK. 


See also: AX25LVL, FRACK 


@® Ring ONIOFF 
default ON 


When ON, three bell characters ($07) are sent to the terminal with each 
“x** CONNECTED TO” message when a connect request is received from another 
station. 


@RNrtime n (n=0- 255) v2.0 
default 0 


RNRTIME is set in 10 second increments. If a connection stays in a remote device 
busy state (continues to receive RNR frames) for RNRTIME, the TNC will disconnect. 
If a KA-Node connection stays in a remote device busy for RNRTIME the KA-Node 
will disconnect the input and output sides of the KA-Node circuit. Setting RNRTIME 
to 0 disables this function. 


See also: MRESP 
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@ RText text (maximum 256 characters, including the command) 
default (blank) 


This string is used to develop the authorization for access to the MYREMOTE. A 
long string should be placed in this parameter if the MYREMOTE is going to be used. 
When a station connects to the MYREMOTE, the Data Engine will generate a series 
of six (6) random numbers between 1 and the length of this string. The six numbers 
will be sent to the connected user, and the Data Engine will not allow remote access 
unless the user correctly decodes the six numbers. These numbers correspond to the 
position of the characters in the RTEXT string. The user will be given a maximum of 
three attempts to decode the string. If the user fails to decode the string properly, the 
Data Engine will disconnect the user and start the 15 minute penalty timer. No new 
connects to the MYREMOTE are possible until the timer expires. 


Case is significant when entering the decoded string, and spaces must ONLY be 
entered if they are a part of the string and the generated number is the location of 
a space. Once entered, a soft reset must be given to activate the desired change. 


See also: MYREMOTE, REMTIMER, RESET 


@SEndpac n (n= $00- $FF) 
default $0D (<CR>) 


This command specifies a character that will force a packet to be sent in the Convers 
Mode. In the Convers Mode, packets are sent when the SENDPAC character is entered 
or when PACLEN is achieved. 


See also: CPACTIME, CR 


@SLottime n (n=0- 255) [10 millisecond increments] 

default 10 DUAL-PORT 
n specifies the amount of time between successive tries of the persistence algorithm. 
See also: PERSIST 


@STARt n (n= $00- $FF) 
default $11 (CTRL-Q) 


This command specifies the character sent by the terminal to the Data Engine to 
restart input from the Data Engine. If set to $00, only hardware flow control will 

be used. For software flow control, set this parameter to the character the computer 
will send to restart data flow. 


See also: FLOWX, STOP, XOFF, XON 


@ Status [LONG] 
immediate 


This command will display both the identifier and link state of any currently 
connected streams. The current input and output (IO) stream is also indicated. A 
pound sign (#) indicates that there is unacknowledged data in the buffers for that 
stream. If LONG is specified, all streams are shown in the listing. 


See also: MAXUSERS, PBBS, STREAMSW 
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@STOp n (n= $00- $FF) 
default $13 (CTRL-S) 


This command specifies the character sent by the computer to the Data Engine to stop 
input from the Data Engine. If set to $00, only hardware flow control will be used. For 
software flow control set this parameter to the character the computer will send to 
stop data flow. 


See also: FLOWX, START, XOFF, XON 


@ STREAMCa ON!OFF 
default OFF 


When monitoring packets addressed only to you, setting this command ON will enable 
the display of the callsign of the connected-to station following the stream identifier of 
the connection (controlled by STREAMEV). This is especially useful when operating 
with multiple connections allowed. 


See also: MONMODE CONNECTED, MONITOR, STREAMEV 


@ STREAMEv ON!OFF 
default OFF 


When OFF, the stream indicator is displayed only when a change in streams occurs. 
When ON, the stream indicator will be displayed with every incoming packet. This 
command takes effect when monitoring only those packets addressed to you. 


See also: MONMODE CONNECTED, MONITOR, STREAMCA, STREAMSW 


@ STReamsw n (n= $00- $FF) 
default $7C (1) DUAL-PORT 


This command selects the character(s) to be used to signify that a new “stream” or 
connection channel is being addressed. The default character (|) may appear as a 
broken vertical line on your keyboard or screen. To change streams, you must type 

the streamswitch character followed immediately by the stream designator. It is not 
necessary to enter the return key after entering this combination. The stream 
designator is an alphabetic character A through Z limited by the value of MAXUSERS. 


If STREAMSW is set to a dollar sign ($24) you will need to enter numerical code type 
parameter values in decimal, or precede the $ with the PASS character in order to 
enter hex numbers. 


The character selected can be PASSed in the Convers Mode by using a special PASS 
character, and will always be passed as data in the Transparent Mode. If operating in 
the Transparent Mode and you wish to change streams, you must first return to the 
Command Mode. 


See also: MAXUSERS, PASS, STATUS 


@TRACe ONIOFF 
default OFF DUAL-PORT 


When ON, all received frames are displayed in their entirety, in hexadecimal, 
including all header information. All packets which are also eligible for monitoring 
will be displayed in normal text. 
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@ Trans 
immediate 


This command causes immediate exit from Command Mode into Transparent Mode. 
The current link state is not affected. The 8th bit is sent out as received from the 
terminal, no matter what the parity is set to in the MODE command. Parity settings 
in the sending and receiving computers should be set the same for meaningful com- 
munications. There are no special editing characters, all characters are sent out as 
received. To get out of Transparent Mode, if the BREAK command is ON, send a 
modem break signal, or use the special sequence described under CMDTIME. If 
BREAK is OFF refer to the CMDTIME command for details on exiting the Trans- 
parent Mode. This mode is effective for file transfers, but would not normally be used 
for keyboard to keyboard conversations. 


See also: BREAK, CMDTIME, CONMODE 


@TRIes n (n=0- RETRY -1) 


The TRIES command will display and optionally set the number of attempts which 
have been made to resend a packet which failed to reach its destination. For instance, 
if RETRY is set to 10, TRIES will show how many attempts have already been made 
to pass the data. For example, if TRIES were to show 8 “TRIES 3” would reset the 
counter to make the TNC believe that it had only tried 3 times so far, thus allowing 7 
more attempts before the RETRY limit is exceeded. 


See also: RETRY 


@ TXdelay n (n=0-255) [10 millisecond increments] 
default 30 DUAL-PORT 


This command sets the transmitter key-up delay as 10*n milliseconds. This setting 
establishes the time delay between the application of push-to-talk and AFSK data 
tones to the transmitter. Flags (character to begin packet) are sent during the delay. 
This command needs to be set long enough to give your transmitter time to develop 
full power before data is sent. If set too short, the beginning of the packet will be 
chopped off and another station will never be able to decode your packets. If set too 
long, additional flags at the beginning (heard as a repetitive sound) just wastes air 
time. It may be necessary to increase your TXDELAY to allow the receiving station 
sufficient time for his receiver to detect your signal (i.e. switch from transmit back 
to receive). 


See also: AXDELAY, AXHANG 


@ Unproto dest [via call1[,call2,...,call8]] 
default CQ DUAL-PORT 


In this command, dest is the destination address (this is really just a dummy address 
as no connection takes place). Some people often put their first name or CQ here. 


Calll through call8 are the optional stations which are supposed to relay the packets. 
Up to 8 digipeaters may be specified. This is referred to as a path. 


This command is used to set the digipeat and destination address fields for packets 
sent in the unconnected (unprotocol) mode. Unproto packets do not receive an 
acknowledgement and are not retried. They are sent as Unsequenced I-frames <UI>. 
If dest is set to NONE, no unconnected packets will be sent except for BEACON and 
ID packets. Unconnected packets sent from other units can be monitored by setting 
MONITOR ON, and MONTYPE to UNPROTOS. 


See also: BEACON, BPATH, ID, IPATH 
Data Engine May 12,1993 Version 2.0 COMMANDS 


© Copyright 1990-1993, Kantronics Co., Inc. All Rights Reserved. 
Duplication of this manual or the firmware without permission of Kantronics Co., Inc. is prohibited. 15 


@ UPLOAD 
immediate 


This command allows you to load information from the serial port into the RAM 
memory. For further details, we suggest you purchase the Data Engine Developer’s 
Manual. 


@USers n (n=0- 26) 
default 1 DUAL-PORT 


This command specifies the channels (streams) which may be available to incoming 
connect requests. For example, if USERS = 5, then an incoming connect request will 
connect to the lowest channel A-E, if any of these channels are in the unconnected 
state. If none of the 5 channels are available (all of them are connected), a <dm> 
packet will be sent back to the requesting station and the message +*** connect 
request: (call)” will be output to your terminal. If USERS is set to 0, no one will be 
able to connect to you. If USERS is set higher than MAXUSERS, the extra is ignored 
and the message “USERS LIMITED BY MAXUSERS’” will be displayed. 


See also: MAXUSERS, STREAMSW 


@ Version v2.0 
immediate 


This command causes the Data Engine to display its current version number along 
with the name of the unit. 


@ Xoff n (n= $00- $FF) 
default $13 (CTRL-S) 


This command selects the character sent by the Data Engine to the terminal to stop 
input from the terminal. If set to $00, hardware flow control must be used. For soft- 
ware flow control, set this parameter to the character the computer expects to see to 
stop sending data to the Data Engine. 


See also: FLOWX, XON 


@XON n (n=$00- $FF) 
default $11 (CTRL-Q) 


This command selects the character sent by the Data Engine to the terminal to restart 
input from that device. If set to $00, hardware flow contro! must be used. For software 
flow control, set this parameter to the character the terminal expects to see to restart 
sending data to the Data Engine. 
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Check to be sure the Data Engine is connected to a 12 volt DC supply and that the 
correct polarity has been observed (red wire to positive, black wire to negative). 


Check to be sure the power supply is turned on and operating properly. Measure the 
output voltage from the power supply. It should be between 11 and 14 volts DC for the 
Data Engine to operate properly. 


Check to be sure the front panel on-off switch is depressed. 


LEDs (A1-A8) fail to operate 
Check to be sure the LEDS comman4d is set to ON. The software controlled LEDs will 
not operate with this command turned OFF. 


Will not communicate with computer 
Check the wiring of the supplied modular connector to your computer with your 
manual for the computer serial port and this manual. 


Be sure the cable is firmly seated at both ends. 


Test your computer serial port by placing a jumper between the RD and TD lines of the 
computer serial port. When you run your terminal program and type on the keyboard 
with this jumper in place, everything you type should be echoed back to your receive 
data area of the terminal program. 


Before you call the factory 


We suggest that you contact other packet users in your area, and also computer 
experts to assist in determining that your computer is properly operating. 


Check to be sure the AUX switch is in the out position. 
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TXD Transmit Data. This line is the serial data from the terminal which is to be 
transmitted to the other station by the TNC. It is this line which is used for all 
communication from your terminal to the TNC, including commands. 


RXD Receive Data. This line is used by the TNC to send the data it receives from the 
other station to your terminal. This line is also used to send TNC messages to your 
terminal. 


SG Signal Ground. This line establishes the common reference potential for all 
circuits except Protective Ground. 


RTS Request To Send. This line tells the TNC that the terminal is ready to receive 
data. An ON level tells the TNC it may send data while an OFF level tells it to stop 
sending data. If the terminal for any reason is unable to accept data from the TNC, it 
will cause this line to change to an OFF state, providing that the terminal supports 
hardware flow control. For instance, buffer is full, terminal is turned off, and so on. 


CTS Clear To Send. This line is used by the TNC to tell the terminal whether or not it 
may send data to the TNC. An ON level tells the terminal it may send data while an 
OFF level tells it to stop sending data. This pin is the complement to the RTS pin, 
implementing hardware flow control in the other direction. 


DCD Data Carrier Detect. This line is an output from the TNC indicating connected 
status of the TNC. When a connection exists on the current stream, this line will be 
ON. 


DSR Data Set Ready. Some terminal programs check this pin to see that the TNC is 
operating before allowing you to talk to the TNC. This pin is pulled ON when the Data 
Engine is turned on. 


DTR Data Terminal Ready. Most terminals will supply an ON voltage to this pin 
when powered up and capable of receiving data. This pin is not checked by the Data 
Engine. 


Cable Wiring 

Transmit Data (TD), Receive Data (RD) and Signal Ground (SG) must always be wired 
in order for the TNC and the computer to exchange any data. Many terminal programs 
also require the use of hardware flow control from the TNC. For hardware flow 
control, Request To Send (RTS) and Clear To Send (CTS) must also be wired. Check 
the documentation to your terminal program to see if any other wires are required. 


Some programs want to see Data Set Ready (DSR) to know that the TNC is there 
before operating. If this is the case wire both DSR and Data Terminal Ready (DTR). 
Sometimes you can satisfy the program’s needs by jumpering these two pins at the 
computer end of the cable. Data Carrier Detect (DCD) is needed by some BBS software 
to know that a connection has taken place. This would require wiring DCD. Some 
phone modem programs also want to see a connection before allowing you to even talk 
to the TNC. This case can usually be solved by jumpering DCD to DTR at the 
computer end of the cable. If your computer requires DSR and also DCD, it is perfectly 
acceptable to jumper all three pins (DTR, DSR, and DCD) together on the computer 
end of the cable. 
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The TNC is wired as DCE (Data Communication Equipment). DCE equipment always 
sends its data on the RD wire. DTE (Data Terminal Equipment) talks on TD. This 
means that if a computer is wired internally as DCE and attached to the TNC it will 
need to have TD from the computer wired to RD on the TNC, and RD from the 
computer wired to TD of the TNC. Otherwise they will both be talking on the same 
wire and never hear what is said. If properly implemented by the DCE computer, 
hardware flow control may be used by connecting RTS from each device to CTS on the 
other device. 


DB-25 Connector 


OMOOOOOQOOOOOO® OOODOQODOOOO®O 
OOOOOODOOOO® OLHOOBOOVDOOVCOW 
Male (Looking at Pins) Female (Looking at Holes) 


DB-9 Connector 


O@OO® OOO@OO 
©OOO® O©OO® 


Male (Looking at Pins) Female (Looking at Holes) 
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The Data Engine will accept modems from other manufacturers, including the Texnet, 
KONG, G3RUH, HAPN, and TAPR modems. Since these modems will not fit inside the 
Data Engine case, it will be necessary to connect them to the Data Engine through the 
DB-15 connector(s) on the rear panel. 


In order to provide the proper signals to the DB-15 for your external modem, you will 
need to jumper various pins from the internal modem disconnect header to the 
external disconnect header (both inside the Data Engine). The pin assignments for the 
internal header are: 


Pin Purpose 


1 Ground 
2 SYNC 
a TXD 

4 RXD 

5 TRAG 
6 RTEXC 

| RTS 

8 CTS 

9 iBE)9) 
10 DTR 

iG) PB4 

12 PB5 

13 OwL2 
14 INTP4 
15 MSO 

16 MS1 

Li MS2 

18 MS3 

19 Ground 


20 +DC (Supply voltage) 


The various MODEM types are selected by grounding the proper combination of MSO - 
MS3. The standard Kantronics DE1200 modem is a TYPE A modem, which is selected 
by grounding MSO only. 


The Kantronics DE19K2/9K6 (G3RUH) modem is automatically selected by grounding 
MS1, which configures the Data Engine for TYPE B modems. Type B modems supply 
their own transmit clock and return the receive clock to the Data Engine. As a result, 
the MODEM command will not display the baud rate. 


The G3RUH modem and Pac-Comm PSK-1 modem require a 16X clock. This is 
obtained by selecting modem TYPE C (grounding MSO and MS\1). The 16X clock is 
then available on TOUT2. This TYPE applies to most TAPR type modems. 


A type D modem is selected by grounding MS2 only. This is used for loop-back or direct 
wire connection to another unit. 


Most external modems require the TNC to provide the Push-to-Talk signal and 
watchdog timer. Kantronics has a plug-in board to provide these functions and route 
the required signals for external modems to the DB-15 connector. The board has 
jumpers to allow selection of TYPE A, TYPE B, or TYPE C modems and a 15 second 
watchdog timer. 


At present, these are the only modem TYPES supported, although other TYPES can 
be selected by grounding MSO-MS¢4 in accordance with the following chart. (Ground 
the pins marked X) 
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TYPE MSO MS1 MS2 MS3 
A x 
B x 
C Xx x 4 
D x 
E x x 
F x x 
G x x x 
H x 
I Xx x 
J X x 
K x x x 
ib x x 
M x x x 
N x x x 
O x x x x 


If you have, or develop a modem, which requires different signals or a new modem 
TYPE, please send your requirements in a fully documented letter to: 


Kantronics 
L202 eZerdiots 
Lawrence, KS 66046 
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Size: 1-3/4" x 6" x 9" 
Weight: 2-1/2 lbs. 
Power Requirements: 12 VDC <150 ma (with DE1200 installed) 
Watch Dog Timer: ~=2-1/2 minutes 
External Carrier Detect (XCD): Ground active 
PTT Output: Open collector PNP transistor, +40 VDC max. 
Audio Output: 
Output Drive: LO = 10 mv p-p, HI = 50 mv p-p, OFF = 2 v p-p 


Output Impedance: 6002 
(ac coupled) 


Audio Input: 
Input Sensitivity: 20 mv 
Input Impedance (unbalanced): 6002 
Max Input Voltage: 2vp-p 
Lithium Battery Backup: DL2430 
Features: 
Packet, PBBS, Gateway, Host Mode, KA-Node, Remote Access, KISS Mode 
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Rl 10K 
R2 51K 
R3 1M 

R4 10K 
R5 100K 
R7 100K 
R8& 100K 
R9 47K 
R10 1.8K 
Rll 330 
Riz 1K 
R13 1K 
R15 4.7K 
R16 18K 
Rag 22K 
R18 47K 
R19 100K 
R21 100K 
R22 100K 
R23 100K 
R24 220 
R25 220 
R26 220 
R27 100K 
R28 100K 
R29 = 220 

Cal 001luF 
C2 00luF 
C3 00luF 
C4 00luF 
5 001luF 
C6 00luF 
Gy! .00luF 
C8 .luF 
C9 .luF 
C10 .luF 
Cr .luF 
C12 .luF 
Cis .001luF 
fests -luF 
C16 .luF 
C18 .luF 
C19 .luF 
C20 tuk 
C21 47uF_al 
C23 47uF_al 
C24 .luF 
C25 luF_al 
C26 47uF_al 
O27 .luF 
C28 ~=«.luF 
C29. 47uF_al 
C30 47uF_al 
G3i .luF 
C32 ~=.1luF 
G33) lub 
C34 .luF 
C35 .luF 
PARTS LIST 
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.luF 
-luF 
.luF 
-luF 
20pF 
20pF 
-luF 
20pF 


6-50pF_trim 


20pF 
.001luF 
47uF_al 
.luF 
-luF 
.00luF 
.luF 
-luF 
47uF_al 
.00luF 
.001uF 
.00luF 
.00luF 
.00luF 
.001luF 
1N914 
1N914 
1N914 
1N914 
1N914 
1N4001 
1N4001 
1N914 
R_LED 
R_LED 
R_LED 
R_LED 
R_LED 
R_LED 
R_LED 
R_LED 
G_LED 


FER_21-200J 


10uH 
PN2907A 
2N7000 
2N7000 
2N7000 
PN2222 
2N7000 
PN2907A 
74HC257 
MAX691 
85C30 


U6 LTC1044 

U7 27010_W/SCKT 

U8 27010_W/SCKT 

U9 621001LP_W/SCKT 
U10 621001LP_W/SCKT 
Ul1l 74HC373 


U12 74HC02 

U13  74HC10 

U14 74HC20 

U15 74HC04 

U16 V40_W/PGA_SCKT 
U17° +6242B 


U18 74HC138 
U19  74HC257 


U20 74HCO00 
U21 74HC75 
U22 74HC08 
U23  74HC32 


U24 74HC259 
U25 74HC259 
VR1 LM78M05 
VR3  LM317LZ 
VR4 LM317LZ 
X1 19.6608MHz 
X2 32.768KHz 


A_BUS1 
A_EXT1 
A_INT1 
B_BUS2 
B_EXT2 
B_INT2 


20p_DIH 
20p_DIH 
20p_DIH 
20p_DIH 
20p_DIH 
20p_DIH 


JP1 3p_SIH 

JP2 3p_SIH 

JP4 2p_SIH 

JP5 2p SIH 

Api WAST hs | 

JP6 3p_SIH 

SW1 PHA012U10EEM 
SW2 PHA012U10EEM 
CSIP1 .00luF_X7C_SIP 
CSIP2 .00luF_X7C_SIP 
CSIP3 .00luF_X7C_SIP 
CSIP4 .00luF_X7C_SIP 
BT1 2430 Battery Clip 
AP1 2430 Battery 

Jl MLX39-29-1028 
AP12 MLX39-00-0060 
AP13 MLX39-00-0060 
AP14 MLX39-01-2020 
VZ1 TL431 

PA_1 DB15F_PCMNS 
PB_2 DB15F_PCMNS 
PC_3 AMP555153-1 
RSIP1 100K_X8C_SIP 
RSIP2 220_X5_SIP 
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@BBS 29, 30 
Abbreviations 6 
ABORT 33, 35 
Acknowledgment time 18, 58 
Alarm, connect 72 
Alias callsign 65 
ASCII Chart 77 
Assembly 8 
Autobaud routine 9 
AUTOLF 49 
AUX switch 12, 78 
AX25LVL 18, 49 
AXDELAY 49 
AXHANG 50 
Back Panel 6 
Backspace 55 
Battery 6, 83 
Baud Rate 10, 61 
Baud Rate, radio 62 
BBS, see mailbox 22 
BEACON 50 
Beacon, path 50 
Beacon, text 50 
Bell, connect 72 
BPATH 50 
BREAK 50 
BTEXT 50 
Calling CQ 14 
Callsign 65 
Callsigns, entry 47 
CANLINE 50 
CANPAC 51 
Carrier detect, radio 62, 67 
Cautions 6 
Change channel 16, 74 
Change parameters 13, 46 
Change stream 16, 74 
Channels, change 16, 74 
CHECK 51 
Clock 

format 54 

set 55 
Cmd: 9, 13, 46 
CMDTIME 21,51 
CMSG 22, 51 
COMMAND 52 
Command Mode 9, 13 
Commands 

dual-port 48 

enter 46 

format 46 

structure 46 
Computer, cable wiring 7, 79 
Configure 

KA-Node 31 

mailbox 22 

remote access 39 
CONMODE 52 
CONNECT 52 


Connect, tnc to computer 7 
Connect, tnc to radio 8 
Connect 

alarm 72 

automatic to mailbox 51 

custom text 54 

disable 52 

sample 14 

send text 51 

to your mailbox 23 
Connected Mode 14 
CONOK 52 
CONPERM 53 
CONVERS 53 
Convers Mode 14, 16, 20, 53, 


59 
CPACTIME 53 
CQ 14,75 
CR 53 
Cross-connect 38, 60 
CSTAMP 54 
CLE N i 227b4 
CTRL-Q 11, 20, 73, 76 
CTRL-S 11, 20, 74, 76 
CTS. 11 
CWID 54 
Data Bits 10, 61 
Date 
format 54 
set 55 
DAYSTRING 54 
DAYTIME 55 
DBLDISC 55 
DE19K2/9K6 81 
Defaults, factory 72 
DELETE 55 
Delete forwarded messages 
69 
Delete mailbox messages 26 
DIGIPEAT 15, 55 
Digipeating 15 
Disassembly 8 
DISCMODE 55 
DISCONNECT 15, 56 
DISCONNECT MYNODE 
56 
DISCONNECT MYPBBS 56 
DISPLAY 56 
Dual-port commands 48 
Dual-port KISS 45, 60 
Dual-port setup 70 
Duplex, radio 62 
Duplex, to computer 11, 57 
DWAIT 17, 56 
RCOHOP LO all apd 
Edit, mailbox messages 24 
EH? 9 
Enter commands 46 
Factory defaults 72 


Filter 64 

FLOW 57 

Flow control 7, 11, 19, 57, 
stehot ss, Ce mths 

FLOWRE2=10,'11; 20; 57 

FLOWTR 20, 57 

FLOWTX 20, 58 

FLOWX 10, 11, 20, 58 

Format, commands 46 

Forwarding messages 30 

FRACK 18, 58 

Frame acknowledgment 18, 
58 

FREERAM 58 

Front Panel 12 

FTP 43 

G3RUH 81 

Gateway 16 

Gateway callsign 65 

Ground 6 

HAPN 81 

Hard Reset 8 

HELP 58 

Hex 6, 47 

HID 58 

Hold messages 69 

Host Mode 41, 59 

ID 58, 59 

ID text 59 

ID path 59 

INTERFACE 41, 59 

Interference, rfi 5 

IPATH 59 

ITEXT 32, 59 

JHEARD 35, 36 

Kr59 

KONG 81 

KA-Node 31 
allocate circuits 67 
callsign 65 
callsign, wild 66 
configure 31 
disconnect 56 
RNR timer 72 
sign-on message 67 
timer 34, 60 

Kill forwarded messages 69 

Kill mailbox messages 26 

KISS Mode 43, 59 

KISS, dual-port 45, 60 

KISSADDR 60 

KNTIMER 34, 60 

KNXCON 31, 60 

LEDS 12, 60, 78 

LFADD 60 

LIDLIST 60 

Line feed 49, 60 

List mailbox messages 25, 
28 


a SPS SS SS SS 


Data Engine May 12, 1993 


Version 2.0 


© Copyright 1990-1993, Kantronics Co., Inc. All Rights Reserved. 
Duplication of this manual or the firmware without permission of Kantronics Co., Inc. is prohibited. | 1 


INDEX 


Lithium battery 6, 83 
Mailbox 22 
allocate memory 68 
callsign 65 
configure 22 
connecting to 23 
disconnect 56 
hold messages 69 
kill forwarded messages 
69 
log 70 
order of messages 69 
personal messages only 69 
remote access 29 
sign-on message 71 
timer 70 
MAXFRAME 61 
MAXUSERS 16, 61 
MHEARD 61 
MODE 10, 61 
MODEM 62 
Modem break 50 
Modems 81 
Modifications 6 
Modular connector 7 
MONITOR 14, 17, 62 
Monitor 
connected 63 
filter 64 
mailbox 29 
pids 64 
responses 64 
supervisory frames 64 
transmitted data 65 
unprotos 65 
MONLIST 14, 17, 62 
MONMODE 14, 15, 17, 63 
MONTYPE 14, 64 
Multi-Connects 16 
MYALIAS 65 
MYCALL 65 
MYGATE 16, 65 
MYNODE 31, 32, 65 
MYPBBS 22, 65 
MYREMOTE 339, 66 
NDWILD 32, 66 
NHEARD 66 
Node 31 
Node callsign 65 
Node, in id text 32 
Nodes heard 38, 66 
NTEXT 67 
NUMNODES 31, 32, 67 
ONECD 67 
Order of mailbox messages 
69 
Packet Mode 13 
PACLEN 15, 67 
PACTIME 67 
Panel, back 6 
Panel, front 12 
Parameter Types 47 


Parameters, see commands 
47 
Parity 10, 61 
PASS 21, 68 
PASSALL 68 
Password 29, 39, 73 
PATH 15, 16, 64 
PBBS 22, 68 
PBBS, see mailbox 22 
PBFORWARD 30, 68 
PBHEADER 22, 69 
PBHOLD 69 
PBKILLFWD 69 
PBLO 23, 69 
PBPERSONAL 23, 69 
PBTIMER 22, 70 
Penalty timer, KA-Node 60 
Penalty timer, remote access 
rat 
Penalty timer, RNR 72 
PERSIST S17 4710 
PHEARD 23, 70 
PIDSe642 
POLL 19 
PORT 16470 
Power 6, 78, 83 
Precautions 6 
Protocol 13, 59 
PSK-1 81 
PTE XTe225 71 
R: lines 22, 69 
Radio, cable 8 
Radio, key-up time 18, 75 
RAM, amount free 58 
Read mailbox messages 26 
REDISPs71 
RELINK 71 
Remote Access 39 
callsign 66 
mailbox 29 
password 39, 73 
timer 71 
REMTIMER 71 
RESET 41, 72 
Reset, hard 8 
Reset, soft 72 
RESPTIME 72 
RESTORE DEFAULTS 72 
Retries 18 
RETRY 14, 72 
Return/Repair 3 
Reverse forward, mailbox 
29, 68 
RFI 5 
RING 72 
RNRTIME 72 
Round Table Discussions 17 
RS-2e2e (sil oeueag 
RTEXT 29, 39, 73 
RTS 11 
Send mailbox messages 23, 
26521 


SENDPAC 15, 73 
Service Department 3 
SLOTTIME 17, 73 
SMTP 43 
Soft reset 72 
Specifications 83 
START 11, 20, 73 
STATUS 17, 73 
Status of mailbox messages 
24 
Stay 31 
STOP 911; 20, 74 
Stop Bits 10, 61 
STREAMCA 17, 74 
STREAMEV 17, 74 
Streams, change 16 
STREAMSW 16, 74 
Switch streams 74 
Switches 12 
SYSOP 24, 29 
SYSOP password 73 
TAPR 81 
TCP Pa4s 
TELNET 43 
Texnet 81 
Time stamp 54, 64 
Time 
format 54 
set 55 
Timer, mailbox 70 
Timing 17, 56, 58, 75 
TRACE 74 
TRANS 75 
Transmitter, key-up time 75 
Transparent Mode 20, 75 
Transparent, getting out of 
21751 
TRIES 75 
Troubleshooting 78 
TXDELAY 18, 75 
UNPROTO 14, 16, 75 
Unproto Mode 14, 17 
Upgrading 8 
UPLOAD 76 
USERS 16, 76 
VERSION 76 
Warranty 1 
Word Length 10, 61 
XCONNECT 34, 35, 38, 60 
XOFF 11, 20, 76 
XON 11, 20, 76 
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